doubao-image-mcp-server

v1.3.0

Published

5 months ago

MCP server for Doubao image generation and editing capabilities

0High
0Medium
0Low

helios123

mcp doubao image-generation image-editing ai bytedance

Doubao Image MCP Server

一个用于豆包图片生成和编辑功能的 MCP (Model Context Protocol) 服务器，支持在 Cherry Studio 和 Cursor 中使用。

功能特性

文本生成图片: 根据文本提示生成高质量图片
图片到图片: 基于参考图片和提示词生成新图片
多尺寸支持: 支持 1K、2K、4K 分辨率
批量生成: 支持一次生成多张图片（最多3张）
水印控制: 可选择是否添加水印

安装和设置

1. 安装依赖

npm install

2. 环境变量配置

创建 .env 文件或设置环境变量：

# 必需：豆包 API 密钥
export DOUBAO_API_KEY="your-doubao-api-key"

# 可选：豆包 API URL (默认: https://ark.cn-beijing.volces.com/api/v3)
export DOUBAO_API_URL="https://ark.cn-beijing.volces.com/api/v3"

# 可选：豆包模型 (默认: doubao-seedream-4-0-250828)
export DOUBAO_MODEL="doubao-seedream-4-0-250828"

3. 启动服务器

npm start

Cherry Studio 配置

在 Cherry Studio 中添加 MCP 服务器：

打开 Cherry Studio 设置
进入 "MCP Servers" 配置页面
添加新的服务器配置：

{
  "name": "doubao-image",
  "command": "node",
  "args": ["/path/to/doubao-image-mcp-server/index.js"],
  "env": {
    "DOUBAO_API_KEY": "your-api-key",
    "DOUBAO_API_URL": "your-api-url"
  }
}

Claude Desktop 配置

在 Claude Desktop 中配置 MCP 服务器：

方法一：直接指向本地文件

编辑 Claude Desktop 配置文件（通常在 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "doubao-image": {
      "command": "node",
      "args": ["D:/AI/mcp/index.js"],
      "env": {
        "DOUBAO_API_KEY": "your-api-key",
        "DOUBAO_API_URL": "https://ark.cn-beijing.volces.com/api/v3",
        "DOUBAO_MODEL": "doubao-seedream-4-0-250828"
      }
    }
  }
}

方法二：通过 npx 使用（推荐）

如果你将此包发布到 npm，可以使用：

{
  "mcpServers": {
    "doubao-image": {
      "command": "npx",
      "args": ["doubao-image-mcp-server"],
      "env": {
        "DOUBAO_API_KEY": "your-api-key",
        "DOUBAO_API_URL": "https://ark.cn-beijing.volces.com/api/v3",
        "DOUBAO_MODEL": "doubao-seedream-4-0-250828"
      }
    }
  }
}

Cursor 配置

在 Cursor 中配置 MCP 服务器：

打开 Cursor 设置 (Cmd/Ctrl + ,)
搜索 "MCP" 或进入 "Extensions" -> "MCP"
添加服务器配置：

{
  "mcpServers": {
    "doubao-image": {
      "command": "node",
      "args": ["/path/to/doubao-image-mcp-server/index.js"],
      "env": {
        "DOUBAO_API_KEY": "your-api-key",
        "DOUBAO_API_URL": "your-api-url"
      }
    }
  }
}

可用工具

generate_image

文本生成图片工具

参数:

prompt (必需): 描述要生成图片的文本提示
size (可选): 图片尺寸 (1K, 2K, 4K)，默认 1K
reference_images (可选): 参考图片URL数组，用于图片到图片生成
max_images (可选): 生成图片数量 (1-3)，默认 1
watermark (可选): 是否添加水印，默认 true
model (可选): 使用的模型，默认 doubao-seedream-4-0-250828

示例:

生成一张2K分辨率的猫咪图片

image_to_image

图片到图片生成工具