Seedream MCP 集成指南

简介

MCP (Model Context Protocol) 是由 Anthropic 提出的模型上下文协议，它允许 AI 模型（如 Claude、GPT 等）通过标准化接口调用外部工具。借助 AceData Cloud 提供的 Seedream MCP 服务器，您可以直接在 Claude Desktop、VS Code、Cursor 等 AI 客户端中使用字节跳动的 Seedream 来生成和编辑 AI 图像。

环境准备/前置条件

在开始之前，您需要获取 AceData Cloud 的 API Token：

注册或登录 AceData Cloud 平台。
前往 Seedream Images API 页面。
点击"获取"以获取您的 API Token（首次申请者可获得免费配额）。

详细步骤

特性概述

Seedream MCP 服务器提供以下核心功能：

文本生成图像 --- 从文本提示生成高质量图像（支持中文和英文提示）
图像编辑 --- 修改现有图像的风格、背景、属性等
虚拟试穿 --- 在个人照片上虚拟穿衣
多模型支持 --- 支持 Seedream v4.5、v4.0、v3.0 T2I、SeedEdit v3.0 I2I 等模型
多种分辨率 --- 支持 1K、2K、4K 和自适应分辨率
种子控制 --- 通过种子参数实现可重复的生成结果
任务查询 --- 监控生成进度并检索结果

安装与配置

方法 1：推荐使用 pip 安装

bash 复制代码

pip install mcp-seedream-pro

方法 2：源代码安装

bash 复制代码

git clone https://github.com/AceDataCloud/MCPSeedream.git
cd MCPSeedream
pip install -e .

安装完成后，您可以使用 mcp-seedream-pro 命令启动服务。

在 Claude Desktop 中的使用

编辑 Claude Desktop 配置文件：

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

json 复制代码

{
  "mcpServers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

如果使用 uvx（无需预安装包）：

json 复制代码

{
  "mcpServers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

保存配置并重启 Claude Desktop，以在对话中使用与 Seedream 相关的工具。

在 VS Code / Cursor 中的使用

在项目根目录创建 .vscode/mcp.json：

json 复制代码

{
  "servers": {
    "seedream": {
      "command": "mcp-seedream-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

或使用 uvx：

json 复制代码

{
  "servers": {
    "seedream": {
      "command": "uvx",
      "args": ["mcp-seedream-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

可用工具

工具名称	描述
`seedream_generate_image`	从文本提示生成图像
`seedream_edit_image`	编辑或修改现有图像
`seedream_get_task`	查询单个任务的状态
`seedream_get_tasks_batch`	批量查询任务状态
`seedream_list_models`	列出所有可用模型及其能力
`seedream_list_sizes`	列出可用的图像尺寸和分辨率选项

使用示例

配置完成后，您可以直接在 AI 客户端中使用自然语言调用这些功能，例如：

"帮我生成一幅水墨风格的风景画"
"将这张照片的背景更改为星空"
"使用 Seedream v4.5 生成一张 4K 高清肖像"
"在这张照片中的人身上虚拟试穿这件衣服"

常见问题

如何获取 API Token？ 请参考前置条件部分，按照步骤获取您的 API Token。
支持的图像格式有哪些？ 目前支持的主要图像格式为 JPEG 和 PNG。

总结

通过本指南，您可以轻松集成 Seedream MCP 服务器到您的 AI 客户端中，实现图像生成和编辑等功能。希望您能在实际应用中充分发挥这些强大工具的潜力！

如需更多信息，请参考以下链接：

标签：#Seedream #MCP #图像生成 #AI #AceDataCloud