Seedream 4.0 MCP

# Seedream 4.0 和 Seedream 4.5 MCP 生图工具 [](https://github.com/astral-sh/uv)     基于火山引擎 Seedream 4.0 和 Seedream 4.5 API 的 MCP 工具，支持 AI 图像生成。 ## ⚡ 快速安装 ### 方法 1：uvx 一键启动（推荐） ```bash # 直接从 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 ```bash # 下载 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` 中添加： ```json { "mcpServers": { "seedream": { "command": "uvx", "args": [ "git+https://github.com/tengmmvp/Seedream_MCP", "--api-key", "your_api_key_here" ] } } } ``` 重启 Claude Desktop 即可使用。 ## ⚙️ 启动参数 ```bash --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 配置文件路径 ``` ### 使用示例 ```bash # 基础使用 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`，默认`url` - `stream` (可选) - 是否启用流式输出，默认`false` - `optimize_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`，默认`url` - `stream` (可选) - 是否启用流式输出，默认`false` - `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast" - `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true） - `save_path` (可选) - 自定义保存目录路径 - `custom_name` (可选) - 自定义文件名前缀 ### 3. `seedream_multi_image_fusion` - 多图融合 将多张图像融合生成新图像 **参数：** - `prompt` (必需) - 图像融合要求或风格指令，建议不超过 300 个汉字或 600 个英文单词 - `images` (必需) - 输入图像 URL 或本地文件路径列表（2-5 张图像） - `size` (可选) - 图像尺寸：`1K`、`2K`、`4K`，默认使用配置文件值 - `watermark` (可选) - 是否添加水印，默认使用配置文件值（默认 false） - `response_format` (可选) - 响应格式：`url`或`b64_json`，默认`url` - `stream` (可选) - 是否启用流式输出，默认`false` - `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast" - `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true） - `save_path` (可选) - 自定义保存目录路径 - `custom_name` (可选) - 自定义文件名前缀 ### 4. `seedream_sequential_generation` - 组图生成 连续生成多张图像，支持文生组图、单图生组图、多图生组图 **参数：** - `prompt` (必需) - 图像生成的文本提示词，应明确指明生成数量和内容，建议不超过 300 个汉字或 600 个英文单词 - `max_images` (可选) - 最大生成图像数量，范围 1-15，默认 4 - `image` (可选) - 参考图像，支持单张图片（字符串）或多张图片（数组，最多 10 张） - `size` (可选) - 图像尺寸：`1K`、`2K`、`4K`，默认使用配置文件值 - `watermark` (可选) - 是否添加水印，默认使用配置文件值（默认 false） - `response_format` (可选) - 响应格式：`url`或`b64_json`，默认`url` - `stream` (可选) - 是否启用流式输出，默认`false` - `optimize_prompt_options` (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast" - `auto_save` (可选) - 是否自动保存到本地，默认使用全局配置（默认 true） - `save_path` (可选) - 自定义保存目录路径 - `custom_name` (可选) - 自定义文件名前缀 ### 5. `seedream_browse_images` - 图片浏览 浏览工作区中的图片文件，获取文件路径用于图像生成 **参数：** - `directory` (可选) - 要浏览的目录路径，默认当前目录 - `recursive` (可选) - 是否递归搜索子目录，默认`true` - `max_depth` (可选) - 最大搜索深度，范围 1-10，默认 3 - `limit` (可选) - 返回的最大文件数量，范围 1-200，默认 50 - `format_filter` (可选) - 过滤特定图片格式，如`['.jpg', '.png']` - `show_details` (可选) - 是否显示详细文件信息，默认`false` ## 🆘 常见问题 **Q: uvx 命令不存在？** ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` **Q: 如何获取 API 密钥？** 访问 [火山引擎控制台](https://console.volcengine.com/) 创建密钥 **Q: Docker 服务无法启动？** 确保设置了环境变量： ```bash # Linux/macOS export ARK_API_KEY=your_key docker-compose up -d # Windows $env:ARK_API_KEY="your_key" docker-compose up -d ``` ## 🧪 本地开发 ```bash # 克隆仓库 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`）： ```bash # 必需配置 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 ``` ## 👥 贡献者 ### 项目创建者 - **[@tengmmvp](https://github.com/tengmmvp)** - 项目创建者 ### 重要贡献者 - **[@caoergou](https://github.com/caoergou)** - 通过 [PR #2](https://github.com/tengmmvp/Seedream_MCP/pull/2) 贡献了 uvx 支持、Docker 容器化配置、GitHub Actions 自动化发布流程，极大简化了项目的安装与部署体验 ### 参与贡献 欢迎提交 Issue 和 Pull Request！请查看 [GitHub Issues](https://github.com/tengmmvp/Seedream_MCP/issues) 了解当前的讨论和需求。 **🌟 如果您希望参与开发，请先在 Issues 中讨论您的想法！** ## 📄 许可证 这个项目基于 MIT 许可证开源。更多信息请查看 [LICENSE](LICENSE) 文件。