doubao_mcp_server

Doubao MCP Server 为 AI 客户端提供基于火山引擎豆包 API 的多模态生成功能，兼容 MCP 1.9+ 协议。服务器通过 STDIO 与客户端通信，支持文本到图片、文本到视频、图片到视频等多模态任务，并提供图片本地编码为 base64 的工具。可通过 Cursor、Cherry Studio、Claude Desktop 以及 Continue.dev 等客户端进行连接，使用统一的 MCP 配置来管理服务器实例。可选模型包括 doubao-seedream-3-0-t2i-250415（文生图）、doubao-seedance-1-0-lite-t2v-250428（文生视频）和 doubao-seedance-1-0-lite-i2v-250428（图生视频）等，具体使用时需设置 DOUBAO_API_KEY 环境变量以验证 API 权限。

Prerequisites:

• Python 3.13+ (建议在虚拟环境中安装)
• 已获得火山引擎豆包 API Key（DOUBAO_API_KEY）

Install options:

方式一：使用 pip 安装（本地/全局开发模式）

pip install -e .

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

uvx doubao-mcp-server

运行服务器示例:

export DOUBAO_API_KEY=your-api-key-here
python -m doubao_mcp_server

若使用 uvx，请确保你已经安装了 uvx，并将命令路径正确添加到系统环境变量中。

提示与常见问题：

• 请务必将 DOUBAO_API_KEY 设置为有效的火山引擎豆包 API 密钥，缺失或无效密钥会导致鉴权失败。
• 如果遇到 uvx 未找到的问题，请按照文档中的步骤安装 uvx，或通过全局安装来确保 PATH 能正确定位到 uvx 命令。
• MCP 客户端配置示例可直接用于 Cursor、Cherry Studio、Claude Desktop、Continue.dev，确保在 env 中设置 DOUBAO_API_KEY。
• 支持的模型与功能可能随豆包 API 的更新而变动，请定期核对支持的模型名称和功能列表。
• 文生视频和图生视频可能需要较长的处理时间，请根据任务复杂度预留等待时间。