文本转语音集成工具

Zonos TTS MCP for Linux 是一个为Claude AI提供文本转语音功能的集成工具,支持多语言和多种情感语音生成,适用于Linux环境。

  • by angrysky56
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 angrysky56/zonos-tts-mcp-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实例(Phials地下室/区域)
  • 工作音频输出设备
  • 克劳德桌面应用程序

设置

通过Smithery安装

要安装 原始未修改版本 克劳德桌面版Zonos TTS集成自动通过 史密瑟里:

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

手动安装 具有GPU优化的Linux

  1. 确保Zonos API与API实现一起运行(Phials地下室/区域)

  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配置文件(在主目录中搜索包含“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可以使用 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系统由 齐普拉 并且可以通过他们的 API 区域.

许可证

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

备注

  • 确保Zonos API服务器和此MCP服务器都在运行
  • 音频播放需要正确的PulseAudio/PipeWire配置
  • 如果您遇到GPU使用率高的情况,可能需要调整服务器代码中的TTS参数