Zonos TTS MCP for Linux

适用于 Linux 的 Zonos TTS MCP

Zonos TTS 的模型上下文协议集成，可让 Claude 直接在 Linux 系统上生成语音。

概述

本项目使用 Zonos TTS 系统为 Claude AI 提供文本转语音功能。该集成使用模型上下文协议（MCP），让 Claude 能够生成多种语言和情绪的自然语音。

主要功能

• 通过 Claude 进行文本转语音
• 支持多种情绪（中性、开心、悲伤、愤怒）
• 支持多种语言
• 通过 PulseAudio/PipeWire 正常播放音频
• 兼容 Linux 环境

要求

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

设置

通过 Smithery 安装

通过 Smithery 自动安装适用于 Claude 桌面应用的 原版未修改的 Zonos TTS 集成：

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. 控制台输出已重定向到日志文件（/tmp/zonos-tts-mcp.log），而不是标准输出，以防止 JSON 解析错误。
2. 已优化 TTS 参数，以提升性能。

性能优化

此分支包含旨在降低 GPU 负载的性能优化：

• 使用更高效的采样参数（top_p 和 min_p）
• 改进日志处理，避免干扰 MCP 通信

与 Claude 搭配使用

配置完成后，Claude 可以使用 speak_response 工具：

speak_response(
    text="Your text here",
    language="en-us",  # optional, defaults to en-us
    emotion="happy"    # optional: "neutral", "happy", "sad", "angry"
)

致谢

本项目基于 PhialsBasement/zonos-tts-mcp 修改而成，旨在提升 Linux 兼容性和性能。

Zonos TTS 系统由 Zyphra 开发，可通过其 Zonos API 使用。

许可证

许可证信息请参阅原始项目。

备注

• 确保 Zonos API 服务和此 MCP 服务都在运行
• 音频播放需要正确配置 PulseAudio/PipeWire
• 如果 GPU 使用率过高，可以尝试调整服务代码中的 TTS 参数