豆

豆包文生图、图生视频、文生视频MCPServer（MCP&Agent挑战赛）

Doubao MCP Server 是一个基于火山引擎豆包API的MCP（Model Context Protocol）服务器，为AI客户端提供强大的多模态生成能力。该项目将火山引擎豆包的先进AI生成能力集成到支持MCP协议的各种AI客户端中，让用户能够在熟悉的开发环境中直接使用文生图、文生视频、图生视频等功能。

developer-tools

9.5k 查看 · 2026-07-07 更新

简介

Doubao MCP Server

项目简介

Doubao MCP Server 是一个基于火山引擎豆包API的MCP（Model Context Protocol）服务器，为AI客户端提供强大的多模态生成能力。该项目的开发初衷是为了将火山引擎豆包的先进AI生成能力集成到支持MCP协议的各种AI客户端中，让用户能够在熟悉的开发环境中直接使用文生图、文生视频、图生视频等功能。

核心功能特性：

文生图：根据文本描述生成高质量图片
文生视频：根据文本描述生成视频内容
图生视频：基于图片和文本描述生成动态视频
图片编码：支持本地图片文件转换为base64编码
模型配置：支持多种豆包AI模型选择

支持的AI模型：

文生图模型：doubao-seedream-3-0-t2i-250415
图生视频模型：doubao-seedance-1-0-lite-i2v-250428
文生视频模型：doubao-seedance-1-0-lite-t2v-250428

部署指南

环境依赖

Python >= 3.13
火山引擎豆包API密钥

安装方式

方式一：使用pip安装

pip install doubao-mcp-server

方式二：使用uvx安装（推荐）

uvx doubao-mcp-server

客户端配置

Cursor配置

在 ~/.cursor/mcp.json 文件中添加以下配置：

{
  "mcpServers": {
    "doubao-mcp-server": {
      "command": "uvx",
      "args": [
        "doubao-mcp-server"
      ],
      "env": {
        "DOUBAO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cherry Studio配置

打开 Cherry Studio
进入 设置 → MCP Servers → 添加服务器
配置参数：
- 名称: doubao-mcp-server
- 描述: 豆包AI生成服务
- 类型: STDIO
- 命令: uvx
- 参数: doubao-mcp-server
- 环境变量: DOUBAO_API_KEY=your-api-key-here
点击保存并启用

详细图解

配置好后，可以检查到工具有哪些

Claude Desktop配置

在 claude_desktop_config.json 文件中添加：

{
  "mcpServers": {
    "doubao-mcp-server": {
      "command": "uvx",
      "args": ["doubao-mcp-server"],
      "env": {
        "DOUBAO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Continue.dev配置

在 config.json 文件中添加：

{
  "mcpServers": [
    {
      "name": "doubao-mcp-server",
      "command": "uvx",
      "args": ["doubao-mcp-server"],
      "env": {
        "DOUBAO_API_KEY": "your-api-key-here"
      }
    }
  ]
}

API密钥获取

访问火山引擎控制台
注册并登录账户
开通豆包大模型服务（需要分别授权开通各个模型）

火山引擎模型，需要分别授权开通，点击开通管理
在API管理中创建API密钥

API 管理

可用工具

1. set_api_key

设置豆包API密钥

api_key (string): 豆包API密钥

2. text_to_image

根据文本描述生成图片

prompt (string): 图片描述提示词
size (string, 可选): 图片尺寸，默认"1024x1024"
model (string, 可选): 模型名称

支持的图片尺寸: 512x512, 768x768, 1024x1024, 1024x1792, 1792x1024

3. text_to_video

根据文本描述生成视频

prompt (string): 视频描述提示词
duration (string, 可选): 视频时长（秒），默认"5"
ratio (string, 可选): 视频比例，默认"16:9"
model (string, 可选): 模型名称

支持的视频比例: 16:9, 9:16, 1:1

4. image_to_video

根据图片和文本描述生成视频

prompt (string): 视频描述提示词
image_base64 (string): 图片的base64编码字符串
duration (string, 可选): 视频时长（秒），默认"5"
ratio (string, 可选): 视频比例，默认"16:9"
model (string, 可选): 模型名称

5. encode_image_to_base64

将本地图片文件编码为base64字符串

image_path (string): 图片文件路径

使用示例

文生图示例

请使用text_to_image工具生成一张"夕阳下的海边风景"图片

文生视频示例

请使用text_to_video工具生成一个"猫咪在花园里玩耍"的5秒视频

图生视频示例

首先使用encode_image_to_base64将图片编码，然后使用image_to_video生成视频

图解案例（文生生图）

文生视频

生成的视频

注意事项

视频生成任务可能需要较长时间完成，请耐心等待
确保API密钥有足够的配额
生成的内容URL有时效性，请及时保存

故障排除

常见问题

API密钥错误: 确保API密钥正确且有效
网络连接问题: 检查网络连接和防火墙设置
模型不可用: 确认使用的模型名称正确

调试模式

启用详细日志输出：

uvx doubao-mcp-server --verbose

项目信息

许可证: MIT License

作者: wwzhouhui - 75271002@qq.com

版本: v0.1.0

初始版本发布
支持文生图、文生视频、图生视频功能
集成火山引擎豆包API

贡献: 欢迎提交Issue和Pull Request来改进这个项目

工具列表

set_api_key: 设置豆包API密钥
text_to_image: 文生图功能 - 根据文本描述生成图片

Args: prompt: 图片描述提示词 size: 图片尺寸，格式为"宽x高"，如"1024x1024" model: 使用的模型名称

Returns: 包含图片URL或错误信息的字典

image_to_video: 图生视频功能 - 根据图片和文本描述生成视频

Args: prompt: 视频描述提示词 image_base64: 图片的base64编码字符串 duration: 视频时长（秒） ratio: 视频比例，如"16:9" model: 使用的模型名称

Returns: 包含视频URL或错误信息的字典

text_to_video: 文生视频功能 - 根据文本描述生成视频

Args: prompt: 视频描述提示词 duration: 视频时长（秒） ratio: 视频比例，如"16:9" model: 使用的模型名称

Returns: 包含视频URL或错误信息的字典

encode_image_to_base64: 将本地图片文件编码为base64字符串

Args: image_path: 图片文件路径

Returns: 包含base64编码字符串或错误信息的字典

服务配置

[{'mcpServers': {'doubao-mcp-server': {'args': ['doubao-mcp-server'], 'command': 'uvx', 'env': {'DOUBAO_API_KEY': 'your-api-key-here'}}}}]

来源

来源：github
链接：https://github.com/wwwzhouhui/doubao_mcp_server