🚀 Zonos TTS MCP for Linux
一个为Zonos TTS设计的Model Context Protocol（MCP）集成，允许Claude在Linux系统上直接生成语音。本项目使Claude AI能够借助Zonos TTS实现文本转语音功能，让你在Linux环境下也能轻松体验语音交互的魅力。
🚀 快速开始
该项目使Claude AI能够通过Zonos TTS实现文本转语音功能。该集成使用了Model Context Protocol（MCP），使得Claude可以生成多种语言和情感的自然流畅语音。
✨ 主要特性
- 通过Claude进行文本转语音
- 支持多种情感（中性、快乐、悲伤、生气）
- 多语言支持
- 通过PulseAudio/PipeWire正确播放音频
- 兼容Linux环境
📦 安装指南
系统要求
- Node.js
- PulseAudio或PipeWire及其兼容层
- 正在运行的Zonos API实例（PhialsBasement/zonos-api）
- 正常工作的音频输出设备
- Claude桌面应用程序
安装步骤
通过Smithery安装
要自动安装未经修改的原始版本的Zonos TTS集成Claude Desktop，可通过Smithery运行以下命令：
npx -y @smithery/cli install @PhialsBasement/zonos-tts-mcp --client claude
手动安装（适用于带有GPU优化的Linux）
- 确保Zonos API正在运行，并且部署了API实现版本(PhialsBasement/zonos-api)。
- 克隆此仓库：
git clone https://github.com/angrysky56/Zonos-TTS-MCP-Linux.git
cd Zonos-TTS-MCP-Linux
- 安装依赖项：
npm install @modelcontextprotocol/sdk axios zod
- 构建MCP服务器：
npm run build
- 添加到Claude配置文件中：编辑你的Claude配置文件（搜索包含“mcpServers”的文件，通常位于用户主目录下），并在
mcpServers部分添加以下内容：
"zonos-tts-mcp": {
"command": "node",
"args": [
"/path/to/your/Zonos-TTS-MCP-Linux/dist/server.js"
]
}
将/path/to/your/Zonos-TTS-MCP-Linux替换为实际安装该项目的路径。
📚 详细文档
故障排除
控制台中的错误信息
如果你遇到类似以下错误消息：
Unexpected token 'P', 'Playing au'... is not valid JSON
此项目已包含修复这些常见问题的内容：
- 将控制台输出重定向到
stdout，以便在出现问题时更容易调试。 - 修复了音频播放中未终止的问题。
更多故障排除信息
请访问GitHub查看完整的README文件和更多详细信息。
使用说明
Claude可以通过以下命令调用：
await window.zilASA?.api("tts/speak", {
text: "Hello World",
modelId: "your-model-id",
});
参数设置示例
- 文本：要生成语音的文本内容。
- 情感（可选）：设置语音的情感，例如
happy、sad、angry或calm。 - 语言（可选）：指定目标语言，如
en-US或zh-CN。
更多详细信息
请访问GitHub查看完整的文档和更多示例。
📄 许可证
该项目的使用和分发需遵守其许可证协议。