🚀 Zonos TTS 与 MCP 集成

本项目实现了 Zonos TTS 的 Model Context Protocol（MCP）集成，让 Claude 能够直接生成语音，为语音交互提供了便利。

🚀 快速开始

配置完成后，Claude 可自动使用 speak_response 工具实现语音生成。示例代码如下：

speak_response(
    text="Your text here",
    language="en-us",  # 可选，默认为 en-us
    emotion="happy"    # 可选："neutral", "happy", "sad", "angry"
)

✨ 主要特性

• 通过 Claude 实现的文本到语音
• 多种情感支持
• 多语言支持
• 通过 PulseAudio 正确播放音频

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 Zonos TTS 集成，可使用以下命令：

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

手动安装

1. 确保 Zonos 已经运行并集成了我们的 API 实现（PhialsBasement/zonos-api）。
2. 安装依赖项：

npm install @modelcontextprotocol/sdk axios

3. 配置 PulseAudio 访问：

# 你的 Pulse Audio 应该已经正确配置用于音频播放
# MCP 服务器将自动尝试连接到你的脉冲服务器

4. 构建 MCP 服务器：

npm run build
# 这将创建包含编译后服务器的 dist 文件夹

5. 添加到 Claude 的配置文件中： 编辑你的 Claude 配置文件（通常位于 ~/.config/claude/config.json），并在 mcpServers 部分添加以下内容：

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

将 /path/to/your/zonos-mcp 替换为你实际安装 MCP 服务器的路径。

💻 使用示例

基础用法

配置完成后，Claude 自动知道如何使用 speak_response 工具：

speak_response(
    text="Your text here",
    language="en-us",  # 可选，默认为 en-us
    emotion="happy"    # 可选："neutral", "happy", "sad", "angry"
)

🔧 技术细节

要求

• Node.js
• PulseAudio 配置
• 运行中的 Zonos API 实例（PhialsBasement/zonos-api）
• 正常工作的音频输出设备

⚠️ 重要提示

• 确保 Zonos API 服务器和此 MCP 服务器都在运行。
• 音频播放需要正确的 PulseAudio 配置。