STARWARCLOUD STARWAR.AI
返回市场
多宝语音合成服务器

多宝语音合成服务器

作者：lxy21099 星标更新：2025-05-22
安装使用来源：spider==github.com

项目介绍

项目介绍

本项目的目的是将火山引擎TTS官方API封装成一个标准的MCP协议工具，支持通过自然语言参数调用在Cursor和Claude等平台上一键合成语音。适用于需要自定义音色、参数映射以及自动化批量语音生成的开发者场景。

Doubao_tts_macp 使用说明

快速开始

0. 克隆项目代码

git clone https://github.com/lxy2109/doubao-tts-mcp.git
cd doubao-tts-mcp

准备Python环境

  • 该项目要求Python版本3.8或以上。
  • 推荐使用Python官方网站下载并安装最新版本。
  • 安装后，在命令行中输入python --version或python3 --version检查版本。

1. 安装依赖

pip install -r requirements.txt

2. 安装本地包（支持命令行调用）

pip install -e .

3. 配置环境变量

可以在.env或mcp.json的env字段中设置： （获取方式： https://console.volcengine.com/speech/service/10007 ）

  • VOLC_APPID
  • VOLC_TOKEN
  • PORT（如果需要自定义端口）
  • OUTPUT_DIR（音频输出目录）

4. 命令行启动服务

doubao-tts-mcp

5. 示例配置cursor mcp.json

{
  "mcpServers": {
    "doubao_tts_mcp": {
      "command": "doubao-tts-mcp",
      "args": [],
      "env": {
        "VOLC_APPID": "你的appid",
        "VOLC_TOKEN": "你的token",
        "PORT": "5001",
        "OUTPUT_DIR": "D:/doubao_tts_mcp/output"
      }
    }
  }
}

6. 在Cursor/Claude等平台上的使用

  • 平台会自动读取mcp.json，并使用命令行启动MCP服务。
  • 在MCP面板上填写参数，即可一键合成音频。
  • 合成的结果会返回音频文件的绝对路径，保存在指定的目录中。

7. 常见问题

  • 问：如何让MCP工具支持命令行调用？
    • 答：请确保pyproject.toml配置了entry_points，并使用pip install -e来安装本地包。
  • 问：比特率和采样率可以调整吗？
    • 答：由于MCP工具中的模式类型验证限制，比特率和速率参数暂时不可用。建议使用默认值。
  • 问：如何填写音色、情感和语速等参数？
    • 答：支持自然语言关键词（如“女孩”和“萝莉”），这些关键词会自动智能地映射到官方音调。

示例调用

{
  "text": "测试声音参数",
  "voice_type": "少女",
  "speed_ratio": 0.8,
  "emotion": "happy",
  "output_filename": "少女音色测试"
}

参考资料