STARWARCLOUD STARWAR.AI
返回市场
重要-mcp-服务器

重要-mcp-服务器

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

项目介绍

中要 MCP 服务器

项目介绍

中要 MCP 服务器是一个基于火山引擎豆包大模型 API 和 MCP（模型上下文协议）协议的人工智能工具服务器。它专注于传统中医药领域，并提供一系列强大的多模态内容生成工具。通过此服务器，用户可以轻松地在支持 MCP 的客户端（如 Trae 和 Cherry Studio）上，只需点击一下即可生成包含详细信息、图像、语音评论和视频的完整短片，针对指定的中药材。

该项目的核心是将复杂的多步骤和多模态生成过程（包括数据查询、文案撰写、语音合成、视频生成和后合成）封装成一个简单易用的工具，大大简化了中医药科普内容的创作过程。

核心功能特性：

  • 文本转图像根据文本描述生成高质量图像
  • 文本转语音生成根据文本生成 TTS 语音广播
  • 文本转视频根据文本描述生成视频内容
  • 图像转视频根据图像和文本描述生成动态视频
  • 模型配置支持多种豆包 AI 模型选择

支持的 AI 模型：

  • 语言模型：deepseek-v3-250324
  • 文生图模型：doubao-seedream-3-0-t2i-250415
  • 图像生成视频模型：doubao-seedance-1-0-lite-i2v-250428
  • 文生视频模型：doubao-seedance-1-0-lite-t2v-250428
  • 文本转语音生成：edgetts（免费）

部署指南

环境依赖

  • Python >= 3.11

  • 火山引擎豆包 API 密钥

    我们使用 UV 管理这个 MCP 依赖包，因此 pyproject.toml

dependencies = [
    "mcp[cli]>=1.9.4", # 添加 requests 依赖
    "requests>=2.31.0",
    "openai>=1.86.0",
    "cos-python-sdk-v5==1.9.33",
    "moviepy==1.0.3",
    "httpx",
]

配置文件描述

我们在 config.ini 文件中使用以下内容来配置此代码

# config.ini
[API]
api_key = YOUR_API_KEY_HERE
base_url = https://ark.cn-beijing.volces.com/api/v3

[Models]
# 语言模型
chat_model = deepseek-v3-250324
# 文生图模型
image_model = doubao-seedream-3-0-t2i-250415
# 文生视频模型
video_model = doubao-seedance-1-0-lite-t2v-250428

[edgetts]
tts_api_key =zhouhuizhou
tts_base_url=https://edgettsapi.duckcloud.fun/v1

[common]
cos_region  = ap-nanjing                                     # 腾讯云OSS存储Region
cos_secret_id  = AKID003XXXXXXgO9qPl                         # 腾讯云OSS存储SecretId
cos_secret_key  = IZhavCXXXXXXXXXXX6i9NXUFqGTUOFvS           # 腾讯云OSS存储SecretKey
cos_bucket =tts-1258720957                                   # 腾讯云OSS存储bucket

# font_path = /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc
# [Windows 用户配置]
imagemagick_binary = D:\develop\ImageMagick-7.1.1-Q16\magick.exe
font_path = SimHei
# [Linux 用户配置]
# imagemagick_binary = /home/ImageMagick/magick
# font_path = /usr/share/fonts/truetype/wqy/wqy-zenhei.ttc

需要修改火山引擎的 api_key 并添加您自己的腾讯云 OSS 存储。用程序安装目录替换 imagemagick-binary

容器版本的 'config.docker.ini' 只需修改火山引擎的 API 密钥和腾讯云 OSS 存储。默认安装了 imagemagick 容器镜像（无需考虑）

安装方法

方法 1：使用 pip 安装

pip install zhongyao-mcp-server

方法 2：使用 UVX 安装

uvx zhongyao-mcp-server

方法 3：使用 Docker 安装（推荐）

在当前代码目录下输入以下命令

docker build -t zhongyao_mcp_server .

88ac744c-bc42-4474-b3f4-7d70dfae5e8d

打包镜像后，我们可以查看容器镜像

image-20250702131535935

启动运行容器

docker run -d -p 8003:8003 --name zhongyao_mcp_server_instance zhongyao_mcp_server

image-20250702131512291

客户端配置

Trae 配置

添加以下配置。请确保将 DOUBAO_API_KEY 替换为您实际的火山引擎豆包 API 密钥。

工作室使用配置文件方法

{
  "mcpServers": {
    "zhongyao-mcp-server": {
      "name": "中药AI视频生成服务",
      "description": "提供中药信息查询、文案、语音、视频生成及最终合成的服务。",
      "command": "uvx",
      "args": [
        "zhongyao-mcp-server"
      ],
      "env": {
        "ini": "F:\\work\\code\\AIcode\\zhongyao_mcp_server\\config.ini"
      }
    }
  }
}

工作室使用从环境变量加载

{
  "mcpServers": {
    "zhongyao-mcp-server": {
      "name": "中药AI视频生成服务",
      "description": "提供中药信息查询、文案、语音、视频生成及最终合成的服务。",
      "command": "uvx",
      "args": [
        "zhongyao-mcp-server"
      ],
      "env": {
        "DOUBAO_API_KEY": "火山引擎APIKEY",
        "DOUBAO_BASE_URL": "https://ark.cn-beijing.volces.com/api/v3",
        "DOUBAO_CHAT_MODEL": "deepseek-v3-250324",
        "DOUBAO_IMAGE_MODEL": "doubao-seedream-3-0-t2i-250415",
        "DOUBAO_VIDEO_MODEL": "doubao-seedance-1-0-lite-t2v-250428",
        "TTS_API_KEY": "自定义TTS密码",
        "TTS_BASE_URL": "https://edgettsapi.duckcloud.fun/v1",
        "COS_REGION": "ap-nanjing",
        "COS_SECRET_ID": "AKID0036B**********zSI1VjgO9qPl",
        "COS_SECRET_KEY": "IZhavCL********88XUFqGTUOFvS",
        "COS_BUCKET": "tts-1258720957"
      }
    }
  }
}

SSE 配置

{
  "mcpServers": {
    "zhongyao-mcp-server": {
      "url": "http://192.168.1.3:8003/sse"
    }
  }
}

image-20250702131450052

Cherry Studio 配置

  1. 打开 Cherry Studio

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

  3. 配置参数：

    • 名称：zhongyao-mcp-server
    • 描述：中药AI生成服务
    • 类型：STDIO
    • 命令：uvx
    • 参数：zhongyao-mcp-server
    • 环境变量：ini 程序需要依赖 config.ini

  4. 点击保存并启用

    详细图表

    image-20250702131429098

SSE 配置

image-20250702131410104

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

image-20250702131329038

STDIO 配置

image-20250702131307661

img

跨平台注意事项

为了确保在不同操作系统（如 Linux 和 Windows）上的顺利运行，请注意以下事项：

  1. 配置文件 config.ini：
    • 项目打包后，config.ini 文件不会自动安装到系统路径。您需要手动将 config.docker.ini 复制到运行程序的目录并重命名为 config.ini。
    • 根据您的实际环境修改 config.ini 文件中的配置项，特别是 API 密钥和外部工具的路径。
  2. ImageMagick 和 FFmpeg：
    • moviepy 库依赖于外部工具 ImageMagick 和 FFmpeg 来处理视频和图像。这些工具需要单独安装，不会随 Python 包一起分发。
    • 安装：请根据您的操作系统从官方网站下载并安装 ImageMagick 和 FFmpeg。
    • 配置：安装后，请确保 config.ini 文件中的 [common] 部分正确配置了 imagemagick_binary 路径。例如：
      • Windows: imagemagick_binary = D:\develop\ImageMagick-7.1.1-Q16-HDRI\magick.exe（请替换为您实际的安装路径）
      • Linux: imagemagick_binary = /usr/bin/magick（如果已添加到 PATH，则可能不需要完整路径）
    • 如果未配置 imagemagick_binary，MoviePy 将尝试在系统 PATH 中搜索。建议进行配置以避免潜在问题。

API 密钥获取

  1. 访问 火山引擎控制台

  2. 注册并登录您的账户

  3. 打开豆包大模型服务（需要分别授权打开每个模型） 火山引擎模型需要分别授权和激活。点击激活管理按钮

    image-20250702131240244

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

    API 管理

    image-20250702131219078

可用工具

2. 获取中药材信息

获取传统中药材的详细信息。

  • herb_name (字符串)：中药材的名称。
  • model (字符串，可选)：用于获取信息的模型名称，默认为 DEFAULT_CHAT_MODEL。

3. 获取中药材图像

根据中药材名称生成图像。

  • herb_name (字符串)：中药材的名称。
  • size (字符串，可选)：图像大小，默认 "1024x1024"。
  • model (字符串，可选)：用于生成图像的模型名称，默认为 DEFAULT_IMAGE_MODEL。 支持的图像尺寸：512x512, 768x768, 1024x1024, 1024x1792, 1792x1024

4. 获取中药材视频

根据中药材名称生成视频。

  • herb_name (字符串)：中药材的名称。
  • duration (字符串，可选)：视频时长（秒），默认 "8"。
  • ratio (字符串，可选)：视频比例，默认 "16:9"。
  • model (字符串，可选)：用于生成视频的模型名称，默认为 DEFAULT_VIDEO_MODEL。 支持的视频比例：16:9, 9:16, 1:1

5. 文本转语音

将文本转换为语音并上传至 COS。

  • text (字符串)：需要转换为语音的文本。
  • voice (字符串，可选)：语音模型，默认 "zh CN XiaoxiaoNeural"。
  • speed (浮点数，可选)：语音播放速度，默认 1.0。

6. 生成中药材短视频

生成关于特定中药材的完整短视频，包括信息获取、文案生成、语音合成和视频合成。

  • herb_name (字符串)：中药材的名称。

使用示例

示例：获取中药材信息

请使用 get_chinese_herb_info 工具获取“人参”的详细信息

2. 示例：生成中药材图像

请使用 get_chinese_herb_image 工具生成一张“枸杞”的图片

3. 生成中药材视频示例

请使用 get_chinese_herb_video 工具生成一个“当归”的8秒视频

4. 文本转语音示例

请使用 generate_audio_from_text 工具将“你好，这是一个测试语音。”转换为语音

image-20250702131200253

5. 生成中药材短视频示例

请使用 generate_herb_short_video 工具生成“三七”的短视频

image-20250702131127743

注意事项

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

常见问题

常见问题

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

**