Doubao Image MCP Server 🎨

这是一个基于 Model Context Protocol (MCP) 的图像生成服务，深度集成了字节跳动 豆包（Doubao）SeeDream 大模型的图像生成能力。

通过此服务器，您可以直接在 Claude Desktop、Cursor 或任何支持 MCP 的客户端中调用豆包的文生图和图生图能力。

✨ 功能特性

• 🚀 文生图 (Text-to-Image): 输入一段文字描述，即可生成高质量、高分辨率的创意图像。
• 🖼️ 图生图 (Image-to-Image): 基于参考图（URL 或 Base64）和修改指令，生成风格一致或更具创意的新图。
• 🛠️ 多模型支持: 默认支持 doubao-seedream-4-5-251128，同时兼容 4.0 和 SeedEdit 系列。
• 📏 灵活尺寸: 支持 1K (1024x1024), 2K (2048x2048), 4K (4096x4096) 等多种导出比例。
• 📜 实时日志: 完整的后台运行日志（输出至 stderr），方便调试和排错。

🚀 快速开始

1. 环境准备

• 获取豆包 ARK API Key: 火山引擎控制台
• 安装 Node.js (建议 v18+)

2. 安装并运行

您可以选择直接使用 npx 预览运行，或者全局安装。

方案 A：使用 npx (推荐用于测试)

export ARK_API_KEY="您的_API_KEY"
npx feedmob-kuma-doubao-image-mcp

方案 B：全局安装

npm install -g feedmob-kuma-doubao-image-mcp

🔧 客户端配置 (Claude Desktop)

为了在 Claude Desktop 中使用，请修改您的配置文件。

配置文件路径

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

配置内容

在 mcpServers 部分添加以下配置：

{
  "mcpServers": {
    "doubao-image": {
      "command": "npx",
      "args": ["-y", "feedmob-kuma-doubao-image-mcp"],
      "env": {
        "ARK_API_KEY": "您的_火山引擎_API_KEY"
      }
    }
  }
}

注意：如果您已经全局安装了，可以将 command 改为 feedmob-kuma-doubao-image-mcp 并移除 args 中的 -y 参数。

🛠️ 可用工具 (Tools)

1. text_to_image (文生图)

根据文本描述生成全新的创意图片。

主要参数:

• prompt (String): 必填。图像的详细描述词（支持中英文）。
• size (Enum): 可选。生成的图片尺寸，支持 1K, 2K, 4K (默认 2K)。
• model (String): 可选。使用的模型 ID。
• watermark (Boolean): 可选。是否在图片中包含水印（默认 false）。

2. image_to_image (图生图)

基于一张或多张参考图片和提示词进行二次创作或修改。

主要参数:

• prompt (String): 必填。对修改内容的具体描述。
• image (String/Array): 必填。参考图片的 URL 链接或 Base64 编码字符串。
• size (Enum): 可选。1K, 2K, 4K (默认 2K)。
• model (String): 可选。

⚙️ 环境变量

| 变量名 | 说明 | 是否必填 | | :--- | :--- | :--- | | ARK_API_KEY | 豆包 火山引擎 ARK 平台的 API 密钥 | 是 |

🛠️ 本地开发

如果您想基于此工程进行二次开发：

1. 克隆仓库

   git clone https://github.com/your-username/doubao-image-mcp.git
   cd doubao-image-mcp

2. 安装依赖

   npm install

3. 脚本说明

   • npm run dev: 使用 tsx 直接运行源码（开发调试）。
   • npm run build: 编译 TypeScript 为生产环境 JavaScript（dist 目录）。
   • npm run prepare: 发布前的自动构建钩子。

🐛 故障排除 (Troubleshooting)

• 找不到 API Key: 请确保在启动服务的 Shell 环境中设置了 ARK_API_KEY，或者在客户端配置的 env 部分正确配置了该变量。
• Claude 显示连接失败:
  • 检查 npx 是否安装。
  • 检查配置文件路径是否正确。
  • 检查 stdout/stderr 冲突（注：MCP 协议要求 stdout 纯净，此服务器日志均已重定向至 stderr）。
• 图片无法显示: 豆包生成的链接通常具有时效性，请及时点击链接查看或保存。

📄 开源协议

本项目采用 MIT License 许可协议。

🤝 贡献与反馈

欢迎提交 Issue 或 Pull Request 来完善这个插件！

Powered by Doubao SeeDream & MCP