Seedream 4.0 和 Seedream 4.5 MCP 生图工具
基于火山引擎 Seedream 4.0 和 Seedream 4.5 API 的 MCP 工具，支持 AI 图像生成。
⚡ 快速安装
方法 1：uvx 一键启动（推荐）
# 直接从 GitHub 仓库启动
uvx git+https://github.com/tengmmvp/Seedream_MCP --api-key your_api_key_here
# 或者先克隆再启动
git clone https://github.com/tengmmvp/Seedream_MCP
cd Seedream_MCP
uvx . --api-key your_api_key_here
方法 2：Docker Compose
# 下载 docker-compose.yml
curl -O https://raw.githubusercontent.com/tengmmvp/Seedream_MCP/main/docker-compose.yml
# 启动服务
ARK_API_KEY=your_api_key_here docker-compose up -d
🔧 Claude Desktop 配置
在 claude_desktop_config.json 中添加：
{
"mcpServers": {
"seedream": {
"command": "uvx",
"args": [
"git+https://github.com/tengmmvp/Seedream_MCP",
"--api-key",
"your_api_key_here"
]
}
}
}
重启 Claude Desktop 即可使用。
⚙️ 启动参数
--api-key TEXT # API 密钥（必需）
--model [doubao-seedream-4.5|doubao-seedream-4.0] # 模型选择 (默认: doubao-seedream-4.5)
--default-size [1K|2K|4K] # 图像尺寸 (默认: 2K)
--watermark # 启用水印
--log-level [DEBUG|INFO|WARNING|ERROR] # 日志级别
--transport [stdio|sse|streamable-http] # MCP 传输方式 (默认: stdio)
--config-file TEXT # 自定义 .env 配置文件路径
使用示例
# 基础使用
uvx git+https://github.com/tengmmvp/Seedream_MCP \
--api-key your_key
# 高质量图像 + 调试模式
uvx git+https://github.com/tengmmvp/Seedream_MCP \
--api-key your_key --default-size 4K --log-level DEBUG
# 使用 Seedream 4.0 模型
uvx git+https://github.com/tengmmvp/Seedream_MCP \
--api-key your_key --model doubao-seedream-4.0
# 使用自定义配置文件
uvx git+https://github.com/tengmmvp/Seedream_MCP \
--config-file ./my-config.env --api-key your_key
🎨 功能特性
- 文生图：文本生成图像
- 图生图：图像转换风格
- 多图融合：融合多张图片
- 组图生成：生成图像序列
- 图片浏览：本地图片文件浏览
🛠️ 可用工具
1. seedream_text_to_image - 文生图
根据文本提示词生成图像
参数：
prompt(必需) - 图像生成的文本提示词，建议不超过 300 个汉字或 600 个英文单词size(可选) - 图像尺寸：1K、2K、4K，默认使用配置文件值watermark(可选) - 是否添加水印，默认使用配置文件值（默认 false）response_format(可选) - 响应格式：url或b64_json，默认urlstream(可选) - 是否启用流式输出，默认falseoptimize_prompt_options(可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"auto_save(可选) - 是否自动保存到本地，默认使用全局配置（默认 true）save_path(可选) - 自定义保存目录路径custom_name(可选) - 自定义文件名前缀
2. seedream_image_to_image - 图生图
根据输入图像和文本提示生成新图像
参数：
prompt(必需) - 图像修改要求或风格转换指令，建议不超过 300 个汉字或 600 个英文单词image(必需) - 输入图像的 URL 或本地文件路径size(可选) - 图像尺寸：1K、2K、4K，默认使用配置文件值watermark(可选) - 是否添加水印，默认使用配置文件值（默认 false）response_format(可选) - 响应格式：url或b64_json，默认urlstream(可选) - 是否启用流式输出，默认falseoptimize_prompt_options(可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"auto_save(可选) - 是否自动保存到本地，默认使用全局配置（默认 true）save_path(可选) - 自定义保存目录路径custom_name(可选) - 自定义文件名前缀
3. seedream_multi_image_fusion - 多图融合
将多张图像融合生成新图像
参数：
prompt(必需) - 图像融合要求或风格指令，建议不超过 300 个汉字或 600 个英文单词image(必需) - 输入图像 URL 或本地文件路径列表（2-5 张图像）size(可选) - 图像尺寸：1K、2K、4K，默认使用配置文件值watermark(可选) - 是否添加水印，默认使用配置文件值（默认 false）response_format(可选) - 响应格式：url或b64_json，默认urlstream(可选) - 是否启用流式输出，默认falseoptimize_prompt_options(可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"auto_save(可选) - 是否自动保存到本地，默认使用全局配置（默认 true）save_path(可选) - 自定义保存目录路径custom_name(可选) - 自定义文件名前缀
4. seedream_sequential_generation - 组图生成
连续生成多张图像，支持文生组图、单图生组图、多图生组图
参数：
prompt(必需) - 图像生成的文本提示词，应明确指明生成数量和内容，建议不超过 300 个汉字或 600 个英文单词max_images(可选) - 最大生成图像数量，范围 1-15，默认 4image(可选) - 参考图像，支持单张图片（字符串）或多张图片（数组）；参考图数量与 max_images 之和不超过 15size(可选) - 图像尺寸：1K、2K、4K，默认使用配置文件值watermark(可选) - 是否添加水印，默认使用配置文件值（默认 false）response_format(可选) - 响应格式：url或b64_json，默认urlstream(可选) - 是否启用流式输出，默认falseoptimize_prompt_options(可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"auto_save(可选) - 是否自动保存到本地，默认使用全局配置（默认 true）save_path(可选) - 自定义保存目录路径custom_name(可选) - 自定义文件名前缀
5. seedream_browse_images - 图片浏览
浏览工作区中的图片文件，获取文件路径用于图像生成
参数：
directory(可选) - 要浏览的目录路径，默认当前目录recursive(可选) - 是否递归搜索子目录，默认truemax_depth(可选) - 最大搜索深度，范围 1-10，默认 3limit(可选) - 返回的最大文件数量，范围 1-200，默认 50format_filter(可选) - 过滤特定图片格式，如['.jpeg', '.png']show_details(可选) - 是否显示详细文件信息，默认false
🆘 常见问题
Q: uvx 命令不存在？
curl -LsSf https://astral.sh/uv/install.sh | sh
Q: 如何获取 API 密钥？ 访问 火山引擎控制台 创建密钥
Q: Docker 服务无法启动？ 确保设置了环境变量：
# Linux/macOS
export ARK_API_KEY=your_key
docker-compose up -d
# Windows
$env:ARK_API_KEY="your_key"
docker-compose up -d
🧪 本地开发
# 克隆仓库
git clone https://github.com/tengmmvp/Seedream_MCP
cd Seedream_MCP
# 安装依赖（开发模式）
uv sync --dev
# 创建 .env 文件
cp .env.example .env
# 编辑 .env 文件，添加您的 API 密钥
# 启动服务
uv run python -m seedream_mcp.server
# 或直接使用 API 密钥启动
uv run python -m seedream_mcp.server --api-key your_key
⚙️ 环境变量配置
主要配置项（详见 .env.example）：
配置优先级：MCP 客户端配置（命令行/环境变量） > .env 文件 > 默认值。
# 必需配置
ARK_API_KEY=your_api_key_here
# 模型配置
SEEDREAM_MODEL_ID=doubao-seedream-4-5-251128
# 默认值
SEEDREAM_DEFAULT_SIZE=2K
SEEDREAM_DEFAULT_WATERMARK=false
# 自动保存（默认启用）
SEEDREAM_AUTO_SAVE_ENABLED=true
SEEDREAM_AUTO_SAVE_BASE_DIR=./seedream_images
SEEDREAM_AUTO_SAVE_DATE_FOLDER=true
SEEDREAM_AUTO_SAVE_CLEANUP_DAYS=30
👥 贡献者
项目创建者
- @tengmmvp - 项目创建者
重要贡献者
参与贡献
欢迎提交 Issue 和 Pull Request！请查看 GitHub Issues 了解当前的讨论和需求。
🌟 如果您希望参与开发，请先在 Issues 中讨论您的想法！
📄 许可证
这个项目基于 MIT 许可证开源。更多信息请查看 LICENSE 文件。