项目简介
SeedDream 4.0 FAL AI MCP 服务是一个基于Model Context Protocol (MCP) 构建的后端服务,旨在为大语言模型(LLM)客户端提供强大的图像生成功能。它通过集成Bytedance的SeedDream 4.0图像模型和FAL AI平台,允许LLM用户通过简单的文本指令生成高质量的图像,并支持高级定制。
主要功能点
- 高级文本到图像生成: 使用SeedDream 4.0模型,通过文本描述生成细节丰富、质量卓越的图像。
- 灵活的图像尺寸: 支持从1024x1024到4096x4096像素的多种预设尺寸或自定义尺寸。
- 多图像批量生成: 可一次性生成多张图像或针对多个提示词进行批量生成。
- 增强的安全检查: 内置内容过滤功能,确保生成的图像内容符合规范。
- 统一的生成与编辑架构: 利用SeedDream 4.0的统一架构,为未来的图像编辑功能预留可能性。
安装步骤
- 获取FAL AI API Key:
- 访问 FAL AI 注册账户并获取您的API密钥。
- 请妥善保管此密钥,后续配置时需要用到。
- 安装Node.js:
- 确保您的系统已安装Node.js (版本16或更高)。您可以通过在命令行运行 'node -v' 来检查。
服务器配置 (供MCP客户端使用)
MCP客户端(如Claude Desktop App或Kilo Code)需要配置以下信息才能连接此服务器。以下是配置的关键要素:
- 名称 (server name): 'seedream4' (这是一个示例名称,您可以根据需要自定义)
- 启动命令 (command):
- 通过 'npx' 运行 (推荐): 'npx'
- 手动安装后运行: 'node'
- 启动参数 (args):
- 通过 'npx' 运行:
- '-y' (自动确认下载)
- 'https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git' (指定GitHub仓库URL)
- 手动安装后运行:
- '/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js' (这是服务器构建后的入口文件路径。您可以在仓库目录下运行 'npm run get-path' 命令获取准确的绝对路径。)
- 通过 'npx' 运行:
- 环境变量 (env):
- 必须设置 'FAL_KEY' 环境变量,其值为您在第一步获取的FAL AI API密钥。例如: '"FAL_KEY": "您的FAL_AI_API_密钥"'
配置示例 (JSON格式说明,请根据您的MCP客户端的配置方式手动添加):
推荐的 'npx' 配置方式:
{ "mcpServers": { "seedream4": { "command": "npx", "args": ["-y", "https://github.com/PierrunoYT/seedream-v4-fal-mcp-server.git"], "env": { "FAL_KEY": "您的FAL_AI_API_密钥" } } } }
手动安装后的配置方式:
{ "mcpServers": { "seedream4": { "command": "node", "args": ["/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js"], "env": { "FAL_KEY": "您的FAL_AI_API_密钥" } } } }
请注意:
- 上述JSON仅为示例结构,您需要将其整合到您的MCP客户端的实际配置文件中。
- 请务必将 '"您的FAL_AI_API_密钥"' 替换为您的真实FAL AI API密钥。
- 手动安装方式中,'/absolute/path/to/seedream-v4-fal-mcp-server/build/index.js' 需要替换为您的本地实际路径。
基本使用方法
配置完成后,您可以在支持MCP的LLM客户端中直接通过自然语言指令调用图像生成功能,例如:
- 基本图像生成: 'Generate an image of a futuristic cityscape at sunset with flying cars' (生成一张未来城市日落景观图,带飞车)
- 自定义图像尺寸: 'Create a wide landscape image (1600x1280) of a serene mountain lake' (生成一张1600x1280的宁静山湖宽幅风景图)
- 生成多张图像: 'Generate 3 variations of a cute robot character (num_images: 3)' (生成3个可爱机器人角色的变体)
- 高分辨率生成: 'Create a detailed portrait in 1536x1536 resolution of a wise old wizard' (生成一张1536x1536分辨率的睿智老法师肖像)
- 批量生成 (多个提示词): 'Generate images for these prompts: "a red rose in morning dew", "a blue ocean wave", "a green forest path"' (为这些提示词生成图像: "清晨露珠红玫瑰", "蓝色海浪", "绿色森林小径")
- 带参数生成: 'Generate a square image (1280x1280) of a magical forest with safety checker enabled and seed 12345' (生成一张1280x1280的魔法森林方图,启用安全检查,使用种子12345)
信息
分类
AI与计算