STARWARCLOUD STARWAR.AI
返回市场
双重保障MCP服务器

双重保障MCP服务器

作者：wwwzhouhui10 星标更新：2025-07-02
安装使用来源：spider==github.com

项目介绍

技术文档摘要

Doubao MCP Server

项目介绍

Doubao MCP Server 是基于火山引擎 Bean Pack API 的 MCP（模型上下文协议）服务器，为支持 MCP 协议的 AI 客户端提供强大的多模态生成能力。该项目的初衷是将火山引擎 Bean Pack 的先进 AI 生成能力集成到各种支持 MCP 协议的 AI 客户端中，使用户能够在熟悉的开发环境中直接使用诸如文本生成图像、文本生成视频和图像生成视频等功能。

核心功能特性：

  • 文本转图像：根据文本描述生成高质量的图像
  • 文本转视频：根据文本描述生成视频内容
  • 图像转视频：根据图像和文本描述生成动态视频
  • 图像编码：支持将本地图像文件转换为 base64 编码
  • 模型配置：支持多种 Bean Bun 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
  • 火山引擎 Bean Pack API 密钥

安装方法

方法 1：使用 pip 安装

pip install doubao-mcp-server

方法 2：使用 UVX 安装（推荐）

uvx doubao-mcp-server

客户端配置

光标配置

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

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

樱桃工作室配置

  1. 打开 Cherry Studio

  2. 进入 设置 → MCP 服务器 → 添加服务器

  3. 配置参数：

    • 名称：doubao-mcp-server
    • 描述：豆包AI生成服务
    • 类型：STDIO
    • 命令：uvx
    • 参数：doubao-mcp-server
    • 环境变量：DOUBAO_API_KEY=your-api-key-here

  4. 点击保存并启用

    详细图表

    image-20250615165107667

image-20250615165205135

配置完成后，可以检查可用的工具

image-20250615165249803

Claude Desktop 配置

在 claude_desktop_config.json 中添加：

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

继续. dev 配置

在 config.json 中添加：

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

获取 API 密钥

  1. 访问 火山引擎控制台

  2. 注册并登录您的账户

  3. 打开 Bean Pack 大模型服务（需要分别授权以打开每个模型）

    火山引擎模型需要分别授权和激活。点击激活管理按钮

    image-20250614201840722

  4. 在 API 管理中创建 API 密钥

    API 管理

    image-20250614201758573

可用工具

1. 设置 API 密钥

设置 Bean Pack API 密钥

  • api_key (字符串)：Bean Pack API 密钥

2. 文本转图像

根据文本描述生成图像

  • prompt (字符串)：图像描述提示词
  • size (字符串，可选)：图像大小，默认 "1024x1024"
  • model (字符串，可选)：模型名称

支持的图像尺寸：512x512, 768x768, 1024x1024, 1024x1792, 1792x1024

3. 文本转视频

根据文本描述生成视频

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

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

4. 图像转视频

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

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

5. 将图像编码为 base64

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

  • image_path (字符串)：图像文件路径

使用示例

文生图示例

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

文生视频示例

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

图生视频示例

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

案例研究（文字、生活与图像）

image-20250615165711353

文字转视频

image-20250615165906609

生成的视频

image-20250615170034340

注意事项

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

常见问题解答

常见问题

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

调试模式

启用详细日志输出：

uvx doubao-mcp-server --verbose

更新记录

2025年6月29日 - 版本 0.0.1：初始版本发布，支持文本生成图像、文本生成视频和图像生成视频。

2025年6月29日 - 版本 0.0.4：移除 set.api_key mcp-1ool 工具，方便用户使用，并通过 DOUBAO-API_KEY 参数赋值

项目信息

许可证：MIT 许可证

作者：wwzhouhui - 75271002@qq.com

版本：v0.0.1

  • 初始版本发布
  • 支持文本生成图像、文本生成视频和图像生成视频的功能
  • 集成火山引擎 Bean Bun API

贡献：欢迎提交 Issue 和 Pull Requests 来改进此项目