Doubao Image Video MCP

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

这是一个支持豆包图片生成和视频生成的 MCP (Model Context Protocol) 服务器，能借助相关模型为你提供高质量的图片和视频生成服务。

🚀 快速开始

本服务器支持豆包图片生成和视频生成，你可以按照以下步骤开启使用之旅。

✨ 主要特性

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

📦 安装指南

本地安装

cd doubao-image-video-mcp
pnpm install
pnpm build

💻 使用示例

基础用法

在使用前，你需要获取 API Key 和创建推理接入点。

获取 API Key

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

创建推理接入点

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

注意：图像生成和视频生成配置不同的接入点。

配置

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"
      }
    }
  }
}

使用 npx -y 可以自动安装最新版本，无需手动管理本地文件。

本地开发配置

如果从源码运行：

{
  "mcpServers": {
    "doubao-giv": {
      "command": "node",
      "args": ["/absolute/path/to/doubao-image-video-mcp/dist/index.js"],
      "env": {
        "DOUBAO_API_KEY": "your_api_key_here",
        "DOUBAO_IMAGE_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx",
        "DOUBAO_VIDEO_ENDPOINT_ID": "ep-20241227-xxxxxxxxxxxxx"
      }
    }
  }
}

环境变量

⚠️ 重要提示

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

支持的工具

1. generate_image

生成单张图片。 参数：

• prompt（必需）：图片描述文本。
• model（可选）：模型选择，默认 doubao-seedream-4-5。
• size（可选）：图片尺寸，默认 2560x1440。
• 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 像素）。

🔧 技术细节

参与贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库。
2. 创建特性分支 (git checkout -b feature/AmazingFeature)。
3. 提交更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到分支 (git push origin feature/AmazingFeature)。
5. 开启 Pull Request。

贡献指南

• 遵循现有代码风格。
• 添加必要的测试和文档。
• 提交前运行 pnpm build 确保构建成功。

发布流程

项目使用 GitHub Actions 自动发布到 npm：

1. 更新 package.json 中的版本号。
2. 创建并推送 Git 标签：

git tag v1.0.0
git push origin v1.0.0

3. GitHub Actions 自动构建并发布到 npm。

Star 历史

📄 许可证

MIT

💡 使用建议

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