doubao-mcp-server 0.0.2

主要实现的是火山引擎的提供的豆包文生图、文生视频、图生视频MCP-Server

Doubao MCP Server

一个基于火山引擎豆包API的MCP（Model Context Protocol）服务器，提供文生图、文生视频、图生视频等AI生成功能。

功能特性

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

支持的模型

文生图模型

• doubao-seedream-3-0-t2i-250415

图生视频模型

• doubao-seedance-1-0-lite-i2v-250428

文生视频模型

• doubao-seedance-1-0-lite-t2v-250428

安装

pip install doubao-mcp-server

或使用uvx（推荐）：

uvx doubao-mcp-server

配置要求

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

MCP客户端配置

Cursor

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

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

Cherry Studio

1. 打开 Cherry Studio
2. 进入 设置 → MCP Servers → 添加服务器
3. 配置如下：
   • 名称: doubao-mcp-server
   • 描述: 豆包AI生成服务
   • 类型: STDIO
   • 命令: uvx
   • 参数: doubao-mcp-server
   • 环境变量:

DOUBAO_API_KEY=your-api-key-here

4. 点击保存并启用

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

可用工具

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生成视频

资源

服务器提供以下资源：

• config://models: 获取可用的AI模型列表
• config://settings: 获取服务器配置信息

API密钥获取

1. 访问 火山引擎控制台
2. 注册并登录账户
3. 开通豆包大模型服务
4. 在API管理中创建API密钥

注意事项

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

故障排除

常见问题

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

调试

启用详细日志输出：

uvx doubao-mcp-server --verbose

许可证

MIT License

贡献

欢迎提交Issue和Pull Request来改进这个项目。

作者

• wwzhouhui - [e-mail]

更新日志

v0.1.0

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