Zonos TTS MCP for Linux

基本能力

产品定位

Zonos-TTS-MCP-Linux 是一个文本转语音（TTS）服务，专为 Claude AI 设计，使其能够在 Linux 系统上生成自然语音。

核心功能

• 通过 Claude 实现文本转语音
• 支持多种情感（中性、快乐、悲伤、愤怒）
• 多语言支持
• 通过 PulseAudio/PipeWire 实现音频播放
• 兼容 Linux 环境

适用场景

• 为 Claude AI 添加语音输出功能
• 在多语言环境中使用 Claude AI
• 需要情感化语音输出的应用场景

工具列表

• speak_response：用于生成语音响应，支持指定语言和情感。

常见问题解答

• 错误消息：如遇到 Unexpected token 'P', 'Playing au'... is not valid JSON 错误，项目已通过重定向控制台输出到日志文件来解决。
• 性能优化：项目已优化以减少 GPU 负载，包括使用更高效的采样参数和改进的日志处理。

使用教程

使用依赖

• Node.js
• PulseAudio 或 PipeWire（带有 PulseAudio 兼容层）
• 运行的 Zonos API 实例（PhialsBasement/zonos-api）
• 可用的音频输出设备
• Claude Desktop 应用

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @PhialsBasement/zonos-tts-mcp --client claude

手动安装（Linux 带 GPU 优化）

1. 确保 Zonos API 正在运行。
2. 克隆仓库：

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

1. 安装依赖：

npm install @modelcontextprotocol/sdk axios zod

1. 构建 MCP 服务器：

npm run build

1. 添加到 Claude 的配置文件： 编辑 Claude 的配置文件（在 home 目录下搜索包含 "mcpServers" 的文件），并在 mcpServers 部分添加：

"zonos-tts-mcp": {
  "command": "node",
  "args": [
    "/path/to/your/Zonos-TTS-MCP-Linux/dist/server.js"
  ]
}

调试方式

• 确保 Zonos API 服务器和 MCP 服务器都在运行。
• 检查音频播放是否正常配置了 PulseAudio/PipeWire。
• 如果遇到高 GPU 使用率，可以调整服务器代码中的 TTS 参数。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。