Skip to main content
Glama
tengmmvp

Seedream 4.0 MCP

by tengmmvp
OverviewInspectSchemaRelated ServersScoreDiscussions
Python
Hybrid

Seedream 4.0 和 Seedream 4.5 MCP 生图工具

uvx Python License MCP Version

基于火山引擎 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，默认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 命令不存在？

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）：

# 必需配置 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

👥 贡献者

项目创建者

重要贡献者

  • @caoergou - 通过 PR #2 贡献了 uvx 支持、Docker 容器化配置、GitHub Actions 自动化发布流程，极大简化了项目的安装与部署体验

参与贡献

欢迎提交 Issue 和 Pull Request！请查看 GitHub Issues 了解当前的讨论和需求。

🌟 如果您希望参与开发，请先在 Issues 中讨论您的想法！

📄 许可证

这个项目基于 MIT 许可证开源。更多信息请查看 LICENSE 文件。

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tengmmvp/Seedream_MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server