中草解说短视频-MCP&Agent挑战赛

zhouqyu666/zhongyao-mcp-server-MCP_Agent_Challenge

Hosted

# 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 ```json 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 内容如下 ```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安装** ```bash pip install zhongyao-mcp-server ``` **方式二：使用uvx安装** ```bash uvx zhongyao-mcp-server ``` **方式三：使用docker安装（推荐）** 在代码当前目录下输入如下命令 ```shell docker build -t zhongyao_mcp_server . ```  打包好镜像，我们可以查看容器镜像  启动运行容器 ```shell docker run -d -p 8003:8003 --name zhongyao_mcp_server_instance zhongyao_mcp_server ```  ### **客户端配置** #### **trae配置** 添加以下配置。请务必将 `DOUBAO_API_KEY` 替换为您的实际火山引擎豆包 API 密钥。 studio 使用配置文件方式 ```json { "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 使用从环境变量加载 ```json { "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配置 ```json { "mcpServers": { "zhongyao-mcp-server": { "url": "http://192.168.1.3:8003/sse" } } } ```  #### **Cherry Studio配置** 1. 打开 Cherry Studio 2. 进入 **设置 → MCP Servers → 添加服务器** 3. 配置参数： - **名称**: `zhongyao-mcp-server - **描述**: `中药AI生成服务` - **类型**: `STDIO` - **命令**: `uvx` - **参数**: `zhongyao-mcp-server - **环境变量**: ini 程序需要依赖config.ini 4. 点击保存并启用 详细图解  sse配置  配置好后，可以检查到工具有哪些  stdio配置   ### **跨平台注意事项** 为了确保在不同操作系统（如 Linux 和 Windows）上顺利运行，请注意以下几点： 1. **配置文件 `config.ini`**: * 项目打包后，`config.ini` 文件不会自动安装到系统路径。您需要手动将 `config.docker.ini` 复制到您运行程序的目录下，并将其重命名为 `config.ini`。 * 请根据您的实际环境修改 `config.ini` 中的配置项，特别是 API 密钥和外部工具的路径。 2. **ImageMagick 和 FFmpeg**: * `moviepy` 库依赖于外部工具 `ImageMagick` 和 `FFmpeg` 来处理视频和图像。这些工具需要单独安装，并且不会随 Python 包一起分发。 * **安装**: 请根据您的操作系统，从官方网站下载并安装 `ImageMagick` 和 `FFmpeg`。 * ImageMagick: [https://imagemagick.org/](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密钥获取** 1. 访问 [火山引擎控制台](https://console.volcengine.com/) 2. 注册并登录账户 3. 开通豆包大模型服务（需要分别授权开通各个模型） 火山引擎模型，需要分别授权开通，点击开通管理  4. 在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有时效性，请及时保存 ## 故障排除 ### **常见问题** 1. **API密钥错误**: 确保API密钥正确且有效 2. **网络连接问题**: 检查网络连接和防火墙设置 3. **模型不可用**: 确认使用的模型名称正确 ### **调试模式** 启用详细日志输出： ```bash uvx zhongyao-mcp-server --verbose ``` ## 项目信息 **许可证**: MIT License **作者**: zhouqingyu666 邮箱 ：zhouqingyu666@aisino.com **版本**: v0.0.5 - 初始版本发布 - 支持文生图、文生视频、图生视频、文字生成语音、中药短视频功能 - 集成火山引擎豆包API、edgetts **贡献**: 欢迎提交Issue和Pull Request来改进这个项目

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

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
[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

pip install zhongyao-mcp-server

uvx zhongyao-mcp-server

docker build -t zhongyao_mcp_server .

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

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

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

studio配置

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

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

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

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

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

uvx zhongyao-mcp-server --verbose