Doubao Tts Mcp
What is Doubao Tts Mcp
doubao-tts-mcp is a project that encapsulates the official TTS API from Volcano Engine into a standard MCP protocol tool. It allows for one-click voice synthesis through natural language parameters on platforms like Cursor and Claude, catering to developers who need to customize voice tones, parameter mapping, and automate batch voice generation.
Use cases
Use cases for doubao-tts-mcp include generating voiceovers for applications, creating audio content for educational purposes, automating responses in customer service, and developing interactive voice applications.
How to use
To use doubao-tts-mcp, clone the project repository, set up a Python environment (Python 3.8 or higher), install the required dependencies, configure environment variables, and start the service via command line. You can then use it on platforms like Cursor and Claude by filling in parameters in the MCP panel to synthesize audio.
Key features
Key features of doubao-tts-mcp include support for natural language voice parameters, customization of voice tones, automated batch processing, and compatibility with multiple platforms like Cursor and Claude.
Where to use
doubao-tts-mcp can be used in various fields such as software development, voice application development, automated customer service, and any scenario requiring voice synthesis.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Doubao Tts Mcp
doubao-tts-mcp is a project that encapsulates the official TTS API from Volcano Engine into a standard MCP protocol tool. It allows for one-click voice synthesis through natural language parameters on platforms like Cursor and Claude, catering to developers who need to customize voice tones, parameter mapping, and automate batch voice generation.
Use cases
Use cases for doubao-tts-mcp include generating voiceovers for applications, creating audio content for educational purposes, automating responses in customer service, and developing interactive voice applications.
How to use
To use doubao-tts-mcp, clone the project repository, set up a Python environment (Python 3.8 or higher), install the required dependencies, configure environment variables, and start the service via command line. You can then use it on platforms like Cursor and Claude by filling in parameters in the MCP panel to synthesize audio.
Key features
Key features of doubao-tts-mcp include support for natural language voice parameters, customization of voice tones, automated batch processing, and compatibility with multiple platforms like Cursor and Claude.
Where to use
doubao-tts-mcp can be used in various fields such as software development, voice application development, automated customer service, and any scenario requiring voice synthesis.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
项目简介
本项目旨在将火山引擎TTS官方API封装为标准MCP协议工具，支持在 Cursor、Claude 等平台通过自然语言参数调用，实现一键语音合成。适用于需要自定义音色、参数映射、自动化批量语音生成的开发者场景。
doubao_tts_mcp 使用说明
快速开始
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. 常见问题
- Q：如何让 MCP 工具支持命令行调用？
- A：请确保 pyproject.toml 配置了 entry_points，并用 pip install -e . 安装本地包。
- Q：比特率及采样率无法调整？
- A：由于 MCP 工具 schema 类型校验限制，bitrate 和 rate 参数暂不可用，建议用默认值。
- Q：音色、情感、语速等参数如何填写？
- A：支持自然语言关键词（如"少女"“萝莉”），会自动智能映射到官方音色。
示例调用
{
"text": "测试声音参数",
"voice_type": "少女",
"speed_ratio": 0.8,
"emotion": "happy",
"output_filename": "少女音色测试"
}参考
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
