Zonos TTS MCP Linux

🚀 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）

1. 确保Zonos API正在运行，并且部署了API实现版本(PhialsBasement/zonos-api)。
2. 克隆此仓库：

git clone https://github.com/angrysky56/Zonos-TTS-MCP-Linux.git
cd Zonos-TTS-MCP-Linux

3. 安装依赖项：

npm install @modelcontextprotocol/sdk axios zod

4. 构建MCP服务器：

npm run build

5. 添加到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

此项目已包含修复这些常见问题的内容：

1. 将控制台输出重定向到stdout，以便在出现问题时更容易调试。
2. 修复了音频播放中未终止的问题。

更多故障排除信息

请访问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查看完整的文档和更多示例。

📄 许可证

该项目的使用和分发需遵守其许可证协议。

🔗 项目来源

• GitHub - Zonos TTS MCP for Linux