Seedream 图像生成 MCP 服务

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "seedream-image-mcp": {
      "command": "uvx",
      "args": ["seedream-image-mcp"],
      "env": { "ARK_API_KEY": "your_api_key_here" }
    }
  }
}

Cline

编辑 Cline 的 MCP 设置 JSON（CLI 为 ~/.cline/mcp.json，IDE 扩展经「MCP Servers → Configure」打开）。Cline 启动的 MCP 进程取不到用户环境变量，ARK_API_KEY 无法依赖环境变量注入，须经配置文件或命令行参数等其他方式传入，本例经配置的 env 字段：

{
  "mcpServers": {
    "seedream-image-mcp": {
      "command": "uvx",
      "args": ["seedream-image-mcp"],
      "env": { "ARK_API_KEY": "your_api_key_here" }
    }
  }
}

Codex

编辑 ~/.codex/config.toml：

[mcp_servers.seedream-image-mcp]
command = "uvx"
args = ["seedream-image-mcp"]

[mcp_servers.seedream-image-mcp.env]
ARK_API_KEY = "your_api_key_here"

OpenCode

编辑 opencode.json（全局为 ~/.config/opencode/opencode.json，也可放项目根目录）：

{
  "mcp": {
    "seedream-image-mcp": {
      "type": "local",
      "command": ["uvx", "seedream-image-mcp"],
      "environment": { "ARK_API_KEY": "your_api_key_here" }
    }
  }
}

其他客户端

凡支持 mcpServers 标准 stdio 结构（command + args + env）的客户端，均可用 Claude Desktop 同款配置。以 Cursor 为例，在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "seedream-image-mcp": {
      "command": "uvx",
      "args": ["seedream-image-mcp"],
      "env": { "ARK_API_KEY": "your_api_key_here" }
    }
  }
}

根据文本提示词生成图像。该工具调用外部计费 API、在本地产出文件，非只读。

参数：

• prompt (必需) - 图像生成的文本提示词，建议不超过 300 个汉字或 600 个英文单词
• optimize_prompt_options (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
• size (可选) - 图像尺寸：1K、1.5K、2K、3K、4K 或 <宽>x<高> 像素值，默认使用配置文件值，需与所选模型兼容
• watermark (可选) - 是否添加水印，默认使用配置文件值（默认 false）
• response_format (可选) - 响应格式：url或b64_json，默认url
• output_format (可选) - 输出文件格式，可选 jpeg 或 png，默认不指定，由 API 按模型默认处理
• stream (可选) - 是否启用流式输出，默认false；开启时 request_count 须为 1
• tools (可选) - 模型工具配置，例如 [{"type":"web_search"}] 开启联网搜索
• request_count (可选) - 同一提示并行发起的独立生成次数，每次各产出一张图，范围 1-10，默认 1
• parallelism (可选) - 并行度上限，范围 1-10，默认 min(request_count, 10)，不得超过 request_count，一般无需手动指定
• auto_save (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
• save_path (可选) - 自定义保存目录路径
• custom_name (可选) - 自定义文件名前缀

调用示例：

{
  "name": "text_to_image",
  "arguments": {
    "prompt": "水彩风格的江南水乡，清晨薄雾"
  }
}

根据输入图像和文本提示生成新图像。该工具调用外部计费 API、在本地产出文件，非只读。

参数：

• prompt (可选) - 图像修改要求或风格转换指令，建议不超过 300 个汉字或 600 个英文单词；仅图层拆分场景可缺省，由模型自动识别拆分意图
• optimize_prompt_options (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
• image (必需) - 输入图像，支持图像 URL、本地文件路径或 Base64 图片数据；本地文件路径须在读取范围内，其中相对路径仅限图片保存目录内
• layer_decomposition (可选) - 是否开启图层拆分；开启后将单张输入图拆解为 1 张底图与最多 16 个带透明通道的 PNG 图层，图层条目额外返回 z_index、name、description、bounding_box 字段；output_format 仅控制底图格式，图层始终为 PNG
• background (可选) - 透明通道，transparent 生成透明背景图（需输入单张带透明通道的图片，与 output_format=jpeg 互斥）或 opaque 生成常规图
• size (可选) - 图像尺寸：1K、1.5K、2K、3K、4K 或 <宽>x<高> 像素值，默认使用配置文件值，需与所选模型兼容；图层拆分场景仅支持 1K、1.5K、2K 档位或 auto（按输入图自适应，未指定尺寸时的默认值）
• watermark (可选) - 是否添加水印，默认使用配置文件值（默认 false）
• response_format (可选) - 响应格式：url或b64_json，默认url
• output_format (可选) - 输出文件格式，可选 jpeg 或 png，默认不指定，由 API 按模型默认处理
• stream (可选) - 是否启用流式输出，默认false；开启时 request_count 须为 1
• tools (可选) - 模型工具配置，例如 [{"type":"web_search"}] 开启联网搜索
• request_count (可选) - 同一提示并行发起的独立生成次数，每次各产出一张图，范围 1-10，默认 1
• parallelism (可选) - 并行度上限，范围 1-10，默认 min(request_count, 10)，不得超过 request_count，一般无需手动指定
• auto_save (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
• save_path (可选) - 自定义保存目录路径
• custom_name (可选) - 自定义文件名前缀

调用示例：

{
  "name": "image_to_image",
  "arguments": {
    "prompt": "把这张人像照片转换为吉卜力动画风格",
    "image": "2026-08-15/image_to_image/portrait.jpeg"
  }
}

将多张图像融合生成新图像。该工具调用外部计费 API、在本地产出文件，非只读。

参数：

• prompt (必需) - 图像融合要求或风格指令，建议不超过 300 个汉字或 600 个英文单词
• optimize_prompt_options (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
• image (必需) - 输入图像（2-14 张），每张支持图像 URL、本地文件路径或 Base64 图片数据；本地文件路径须在读取范围内，其中相对路径仅限图片保存目录内
• size (可选) - 图像尺寸：1K、1.5K、2K、3K、4K 或 <宽>x<高> 像素值，默认使用配置文件值，需与所选模型兼容
• watermark (可选) - 是否添加水印，默认使用配置文件值（默认 false）
• response_format (可选) - 响应格式：url或b64_json，默认url
• output_format (可选) - 输出文件格式，可选 jpeg 或 png，默认不指定，由 API 按模型默认处理
• stream (可选) - 是否启用流式输出，默认false；开启时 request_count 须为 1
• tools (可选) - 模型工具配置，例如 [{"type":"web_search"}] 开启联网搜索
• request_count (可选) - 同一提示并行发起的独立生成次数，每次各产出一张图，范围 1-10，默认 1
• parallelism (可选) - 并行度上限，范围 1-10，默认 min(request_count, 10)，不得超过 request_count，一般无需手动指定
• auto_save (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
• save_path (可选) - 自定义保存目录路径
• custom_name (可选) - 自定义文件名前缀

调用示例：

{
  "name": "multi_image_fusion",
  "arguments": {
    "prompt": "把两张人像融合为一张双人合影，影棚灯光",
    "image": [
      "2026-08-15/multi_image_fusion/person_a.jpeg",
      "2026-08-15/multi_image_fusion/person_b.jpeg"
    ]
  }
}

连续生成多张图像，支持文生组图、单图生组图、多图生组图。该工具调用外部计费 API、在本地产出文件，非只读。

参数：

• prompt (必需) - 图像生成的文本提示词，应明确指明生成数量和内容，建议不超过 300 个汉字或 600 个英文单词
• optimize_prompt_options (可选) - 提示词优化选项，支持 mode: "standard" 或 "fast"
• image (可选) - 参考图像（最多 14 张，且参考图数量与 max_images 之和不超过 15），每张支持图像 URL、本地文件路径或 Base64 图片数据；本地文件路径须在读取范围内，其中相对路径仅限图片保存目录内
• size (可选) - 图像尺寸：1K、1.5K、2K、3K、4K 或 <宽>x<高> 像素值，默认使用配置文件值，需与所选模型兼容
• watermark (可选) - 是否添加水印，默认使用配置文件值（默认 false）
• max_images (可选) - 最大生成图像数量，范围 1-15，默认 15；提供参考图时默认自动扣减为 15 减参考图数量
• response_format (可选) - 响应格式：url或b64_json，默认url
• output_format (可选) - 输出文件格式，可选 jpeg 或 png，默认不指定，由 API 按模型默认处理
• stream (可选) - 是否启用流式输出，默认false；开启时 request_count 须为 1
• tools (可选) - 模型工具配置，例如 [{"type":"web_search"}] 开启联网搜索
• request_count (可选) - 同一提示并行发起的独立生成次数，每次各产出一组图片，组内图片数量由模型按提示词决定，最多 max_images 张，范围 1-10，默认 1
• parallelism (可选) - 并行度上限，范围 1-10，默认 min(request_count, 10)，不得超过 request_count，一般无需手动指定
• auto_save (可选) - 是否自动保存到本地，默认使用全局配置（默认 true）
• save_path (可选) - 自定义保存目录路径
• custom_name (可选) - 自定义文件名前缀

调用示例：

{
  "name": "sequential_generation",
  "arguments": {
    "prompt": "四格漫画：一只柴犬的一天，起床、吃饭、散步、睡觉"
  }
}

浏览工作区中的图片文件，获取文件路径用于图像生成。该工具只读、幂等、不访问网络。

参数：

• directory (可选) - 要浏览的目录路径，默认浏览图片保存目录；相对路径仅限图片保存目录内，绝对路径须在读取范围内。返回的条目为绝对路径，可直接作为参考图路径
• recursive (可选) - 是否递归搜索子目录，默认true
• max_depth (可选) - 最大搜索深度，范围 1-10，默认 3
• limit (可选) - 返回的最大文件数量，范围 1-200，默认 50
• offset (可选) - 分页偏移量（0-100000，从第几张开始返回），配合 limit 翻页，默认 0
• format_filter (可选) - 过滤特定图片格式，如['.jpeg', '.png']
• show_details (可选) - 是否显示详细文件信息，默认false

调用示例：

{
  "name": "browse_images",
  "arguments": {}
}

查询当前配置模型的能力快照，供调用生成工具前确认参数支持情况。该工具只读、不访问网络。

返回字段：

• model_id - 当前配置的模型 ID
• display_name - 家族展示名，未识别家族时为 null
• aliases - 当前模型的全部可用别名
• family - 模型家族；未识别的模型为 unknown，能力按全放行兜底
• capabilities - 提示词优化档位、参考图上限、图层拆分、透明背景、尺寸档位与像素区间，以及 output_format、stream、web_search、sequential_generation 各项支持情况

调用示例：

{
  "name": "get_model_info",
  "arguments": {}
}