Generate images using Bytedance's SeedDream 3.0 model via the FAL AI platform. Requires a FAL AI API key.
A Model Context Protocol (MCP) server that provides image generation capabilities using Bytedance's SeedDream 3.0 model via the FAL AI platform.
SeedDream 3.0 is a bilingual (Chinese and English) text-to-image model that excels at:
generate_imageGenerate a single image or multiple images from a text prompt.
Parameters:
prompt (required): Text description of the image to generate (supports English and Chinese)aspect_ratio (optional): Image aspect ratio - one of: 1:1, 3:4, 4:3, 16:9, 9:16, 2:3, 3:2, 21:9 (default: 1:1)guidance_scale (optional): Controls prompt adherence (1.0-20.0, default: 2.5)num_images (optional): Number of images to generate (1-4, default: 1)seed (optional): Random seed for reproducible results (0-2147483647)generate_image_batchGenerate multiple images with different prompts in a single request.
Parameters:
prompts (required): Array of text prompts (1-5 prompts)aspect_ratio (optional): Aspect ratio for all images (default: 1:1)guidance_scale (optional): Controls prompt adherence (1.0-20.0, default: 2.5)FAL AI API Key: Get your API key from FAL AI
Node.js: Ensure you have Node.js installed (version 16 or higher)
The easiest way to use this server is through npx, which automatically downloads and runs the latest version:
Add the server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"seedream": {
"command": "npx",
"args": [
"-y",
"https://github.com/PierrunoYT/seedream-v3-fal-mcp-server.git"
],
"env": {
"FAL_KEY": "your-fal-api-key-here"
}
}
}
}
Add to your MCP settings file at:
C:\Users\[username]\AppData\Roaming\Code\User\globalStorage\kilocode.kilo-code\settings\mcp_settings.json
{
"mcpServers": {
"seedream": {
"command": "npx",
"args": [
"-y",
"https://github.com/PierrunoYT/seedream-v3-fal-mcp-server.git"
],
"env": {
"FAL_KEY": "your-fal-api-key-here"
},
"disabled": false,
"alwaysAllow": []
}
}
}
✅ Universal Access: Works on any machine with Node.js ✅ No Local Installation: npx downloads and runs automatically ✅ Always Latest Version: Pulls from GitHub repository ✅ Cross-Platform: Windows, macOS, Linux compatible ✅ Settings Sync: Works everywhere you use your MCP client
If you prefer to install locally:
Clone the repository
git clone https://github.com/PierrunoYT/seedream-v3-fal-mcp-server.git
cd seedream-v3-fal-mcp-server
Install dependencies
npm install
Build the server
npm run build
Use absolute path in configuration
{
"mcpServers": {
"seedream": {
"command": "node",
"args": ["/absolute/path/to/seedream-v3-fal-mcp-server/build/index.js"],
"env": {
"FAL_KEY": "your-fal-api-key-here"
}
}
}
}
Helper script to get the absolute path:
npm run get-path
Once configured, you can use the server through your MCP client:
Generate an image of a serene mountain landscape at sunset with a lake reflection
Create a portrait-oriented image of a futuristic cityscape (aspect ratio 9:16)
Generate 3 variations of a cute robot character
Generate images for these prompts: "a red rose", "a blue ocean", "a green forest"
生成一张中国传统山水画的图片
Generate a photorealistic portrait of a person reading a book in a library (guidance scale: 7.5)
The server returns detailed information about generated images:
Successfully generated 1 image(s) using SeedDream 3.0:
Prompt: "a serene mountain landscape at sunset"
Aspect Ratio: 1:1
Guidance Scale: 2.5
Seed Used: 1234567890
Generated Images:
Image 1 (1024x1024): https://v3.fal.media/files/...
# Test the server directly
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node build/index.js
npm run watch
npm run inspector
"FAL_KEY environment variable is not set"
"Server not showing up in Claude"
"Generation failed"
"npx command not found"
node --version and npm --version to verify installation✅ Robust Error Handling: Server continues running even without API token
✅ Graceful Shutdown: Proper handling of SIGINT and SIGTERM signals
✅ User-Friendly Messages: Clear error messages with setup instructions
✅ No More Crashes: Eliminated process.exit() calls that caused connection drops
The server outputs debug information to stderr, which can help diagnose issues:
Image generation costs are determined by FAL AI's pricing structure. Check FAL AI Pricing for current rates.
This project is licensed under the MIT License - see the LICENSE file for details.
For issues related to:
process.exit() calls that caused server crashesInteract with the Futarchy protocol on the Solana blockchain.
Provides LLM access to the Cucumber Studio testing platform for managing and executing tests.
Fetches API information from Feishu OpenAPI for seamless integration and management within an IDE.
A secure command-line interface server for the Model Context Protocol (MCP) that allows AI models to interact with a user's terminal.
Analyzes, optimizes, and detects duplicates in codebases for Claude Code.
Integrates with Microsoft's AutoGen framework to enable sophisticated multi-agent conversations via the Model Context Protocol.
Control emulators by opening/closing apps, capturing screenshots, and interacting with the screen.
Extracts text and performs OCR on various documents like IDs and invoices, with support for Markdown conversion.
A powerful and flexible MCP server designed to enhance the development experience with Shadcn UI components, providing tools for component management, documentation, and installation.
integration that connects BloodHound with AI through MCP, allowing security professionals to analyze Active Directory attack paths using natural language queries instead of Cypher.