快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

ZhongYao MCP Server

项目简介

zhongyao-mcp-server 是一个基于火山引擎豆包大模型API和MCP（Model Context Protocol）协议的AI工具服务器。它专注于中草药领域，提供了一系列强大的多模态内容生成工具。通过本服务器，用户可以轻松地在支持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密钥

这个MCP 依赖包我们使用uv 管理所以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_key和腾讯云OSS存储，imagemagick 容器镜像默认安装（不需要考虑）

安装方式

方式一：使用pip安装

pip install zhongyao-mcp-server

方式二：使用uvx安装

uvx zhongyao-mcp-server

方式三：使用docker安装（推荐）

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

docker build -t zhongyao_mcp_server .

88ac744c-bc42-4474-b3f4-7d70dfae5e8d

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

启动运行容器

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

客户端配置

trae配置

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

studio 使用配置文件方式

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

studio 使用从环境变量加载

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

Cherry Studio配置

打开 Cherry Studio

进入 设置 → MCP Servers → 添加服务器

配置参数：

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

点击保存并启用

详细图解

sse配置

配置好后，可以检查到工具有哪些

stdio配置

跨平台注意事项

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

配置文件 config.ini:

* 项目打包后，config.ini 文件不会自动安装到系统路径。您需要手动将 config.docker.ini 复制到您运行程序的目录下，并将其重命名为 config.ini。 * 请根据您的实际环境修改 config.ini 中的配置项，特别是 API 密钥和外部工具的路径。

ImageMagick 和 FFmpeg:

* moviepy 库依赖于外部工具 ImageMagick 和 FFmpeg 来处理视频和图像。这些工具需要单独安装，并且不会随 Python 包一起分发。 * 安装: 请根据您的操作系统，从官方网站下载并安装 ImageMagick 和 FFmpeg。 * ImageMagick: https://imagemagick.org/ * 配置: 安装完成后，请确保在 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密钥获取

访问火山引擎控制台

注册并登录账户

开通豆包大模型服务（需要分别授权开通各个模型）

火山引擎模型，需要分别授权开通，点击开通管理

在API管理中创建API密钥

API 管理

可用工具

2. get_chinese_herb_info

获取中药材的详细信息。

herb_name (string): 中药材名称。
model (string, 可选): 用于获取信息的模型名称，默认为 DEFAULT_CHAT_MODEL。

3. get_chinese_herb_image

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

herb_name (string): 中药材名称。
size (string, 可选): 图片尺寸，默认"1024x1024"。
model (string, 可选): 用于生成图片的模型名称，默认为 DEFAULT_IMAGE_MODEL。

支持的图片尺寸: 512x512, 768x768, 1024x1024, 1024x1792, 1792x1024

4. get_chinese_herb_video

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

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

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

5. generate_audio_from_text

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

text (string): 需要转换为语音的文本。
voice (string, 可选): 语音模型，默认"zh-CN-XiaoxiaoNeural"。
speed (float, 可选): 语音播放速度，默认1.0。

6. generate_herb_short_video

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

herb_name (string): 中药材名称。

使用示例

1. 获取中药材信息示例

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

2. 生成中药材图片示例

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

3. 生成中药材视频示例

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

4. 文本转语音示例

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

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

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

注意事项

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

故障排除

常见问题

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

调试模式

启用详细日志输出：

uvx zhongyao-mcp-server --verbose

项目信息

许可证: MIT License

作者: zhouqingyu666 邮箱：zhouqingyu666@aisino.com

版本: v0.0.5

初始版本发布
支持文生图、文生视频、图生视频、文字生成语音、中药短视频功能
集成火山引擎豆包API、edgetts

贡献: 欢迎提交Issue和Pull Request来改进这个项目

目录标签

Python语音合成语音音频中草药本地部署多模态生成AI视频生成内容创作

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

none

工具数量（toolCount，工具数）

5

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/476a5997c373e3b0b5f2d64264acf087

ZhongYao MCP Server是一个基于火山引擎豆包大模型API和MCP协议的AI工具服务器，专注于中草药领域，提供文生图、文字生成语音、文生视频、图生视频等多模态内容生成功能，简化中草药科普内容的创作过程。

继续浏览同类 MCP

更多音视频 MCP（1,391）返回 MCP 目录

上一个 MCP

Zapcap MCP Server

ZapCap MCP Server是一个基于Model Context Protocol的服务器，提供视频上传、处理任务创建和进度监控等功能，通过ZapCap API实现。

下一个 MCP

Zntl MCP Server

全面解析Zntl MCP ServerMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Zntl MCP Server能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

Zhongyao MCP Server