Doubao MCP Server

关键词

多模态生成云端 API文本到图像视频生成资源与工具管理

使用说明内容（Markdown格式）

项目简介

Doubao MCP Server 是一个基于 MCP（Model Context Protocol）1.9+ 的服务端实现，将火山引擎豆包 API 的多模态生成功能暴露为 MCP 客户端可调用的后端能力，包含资源管理、工具执行和提示模板渲染等核心能力，支持 STDIO 等传输方式，方便与 AI 客户端（如 Cursor、Claude Desktop、Cherry Studio 等）对接。

主要功能点

  • 文生图（text_to_image）：按文本描述生成图片，支持多种尺寸与模型
  • 文生视频（text_to_video）：按文本描述生成视频，支持时长与比例配置
  • 图生视频（image_to_video）：根据图片和文本描述合成视频
  • 图片编码（encode_image_to_base64）：将本地图片转为 base64 字符串
  • 资源与模型管理（MCP 资源）：提供可用模型清单与服务器设定查看
  • MCP 协议服务：通过 FastMCP 实现工具注册、资源查询等 MCP 请求/响应
  • 环境变量驱动的 API 密钥支持：通过 DOUBAO_API_KEY 配置对接豆包 API
  • 服务器入口：通过 STDIO 传输与 MCP 客户端建立通信，便于在各种前端客户端集成

安装步骤

  • 安装方式一（推荐，直接安装并运行）：
    • 使用 pip 安装：pip install doubao-mcp-server
  • 安装方式二（通过 uvx 启动，快速体验）：
    • uvx doubao-mcp-server
  • 运行方式（命令示例，实际可按环境调整）：
    • uvx doubao-mcp-server
    • 或直接以 Python 模块方式运行：python -m doubao_mcp_server
  • 配置 API 密钥前提
    • 需要在环境变量中设置 DOUBAO_API_KEY，示例如：export DOUBAO_API_KEY=your-api-key-here

服务器配置（MCP 客户端需要先了解并配置）

说明：MCP 客户端（Cursor、Cherry Studio、Claude Desktop 等）需要向 MCP 服务器注册并通过指定的启动命令与参数建立连接。以下信息用于客户端配置，JSON 格式，描述服务器名称、启动命令与参数；请勿直接在客户端执行代码。

{ "server_name": "doubao_mcp_server", "command": "uvx", "args": ["doubao-mcp-server"], "env": { "DOUBAO_API_KEY": "your-api-key-here" } // 说明：上述配置可在客户端的 MCP 设置中填入相应字段，确保客户端在启动时能够正确派发命令并传入所需环境变量 }

基本使用方法

  • 启动服务器后，MCP 客户端即可通过已注册的工具和资源与服务器交互
  • 使用文本到图片、文本到视频、图像到视频等工具时，请在调用参数中传入所需的 prompt、size、duration、ratio、model 等字段
  • 如需将本地图像编码为 base64，可以先执行 encode_image_to_base64 工具，然后将返回的 base64 值传入 image_to_video 或其他需要图像输入的操作
  • 服务器会返回生成结果的 URL 或错误信息，便于客户端展示和错误处理

服务器信息

访问项目