Zonos TTS MCP for Linux

一个用于 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 Desktop 版 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 参数