豆包免费图片/视频生成 MCP 服务器

一个支持豆包图片生成和视频生成的 MCP (Model Context Protocol) 服务器

功能

• 图片生成: 使用豆包 Seedream 模型生成高质量图片
• 视频生成: 使用豆包 Seedance 模型生成视频
• 任务查询: 查询视频生成任务状态

获取 API Key

1. 访问 火山引擎豆包大模型平台
2. 注册/登录账号
3. 在控制台获取 API Key

创建推理接入点

1. 访问 火山引擎控制台
2. 进入「开通管理」页面，参与「协作奖励计划」享免费资源包
3. 授权图片生成接入点（Doubao-Seedream-4.5 模型）
4. 授权视频生成接入点（Doubao-Seedance-1.0-lite-t2v 模型）
5. 进入「安全管理」页面，点击内容安全，复制接入点 ID 到配置文件

PS: 图像生成和视频生成配置不同的接入点

配置

Claude Code 中使用 (推荐)

在 Claude Code 配置文件中添加：

macOS/Linux: ~/.claude/config.json
Windows: %APPDATA%\claude\config.json

{
  "mcpServers": {
    "doubao-giv": {
      "command": "npx",
      "args": ["-y", "doubao-image-video-mcp@latest"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

通用 MCP 客户端配置

{
  "mcpServers": {
    "doubao-giv": {
      "command": "npx",
      "args": ["-y", "doubao-image-video-mcp@latest"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

环境变量

重要：必须在火山引擎控制台创建推理接入点并配置接入点 ID，直接使用模型名称可能因权限问题导致调用失败。

完整配置示例

{
  "mcpServers": {
    "doubao-giv": {
      "command": "npx",
      "args": ["-y", "doubao-image-video-mcp"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

支持的工具

1. generate_image

生成单张图片。

参数：

• prompt (必需): 图片描述文本
• model (可选): 模型选择，默认 doubao-seedream-4-5
• size (可选): 图片尺寸，默认 1024x1024
• image_url (可选): 参考图片 URL (图生图)
• ref_image_urls (可选): 多张参考图片 URL 数组 (多图融合)
• req_key (可选): 请求标识

2. generate_video

生成视频（异步任务）。

参数：

• prompt (必需): 视频描述文本 (最大 500 字符)
• model (可选): 模型选择，默认 doubao-seedance-1.0-lite-t2v
• video_duration (可选): 视频时长 (秒)，默认 5
• fps (可选): 帧率，默认 24
• resolution (可选): 分辨率，默认 1080p
• first_frame_image_url (可选): 首帧图片 URL (图生视频)
• ref_image_urls (可选): 参考图片 URL 数组
• req_key (可选): 请求标识

返回： 任务 ID，需要使用 query_video_task 查询结果

3. query_video_task

查询视频生成任务状态。

参数：

• task_id (必需): 视频生成任务 ID

返回： 任务状态和结果

支持的模型

图片生成模型

视频生成模型

API 文档

• 创建视频生成任务 API
• 查询视频生成任务 API
• 图片生成 API

常见问题

Q: 视频生成需要多长时间？

A: 视频生成是异步任务，通常需要几秒到几分钟，具体取决于视频时长和模型选择。

Q: 如何获取推理接入点 Endpoint ID？

A: 在火山引擎控制台创建推理接入点后获取，使用 endpoint_id 参数比直接使用 model 名称更稳定。

Q: 支持哪些图片尺寸？

A: 图片生成支持多种尺寸，推荐使用 1920x2160、1920x2560、2160x3840 等高分辨率尺寸（豆包 API 要求图片至少 3686400 像素）。

MIT

如果这个项目对你有帮助，请给一个 Star ⭐️