Zonos TTS

🚀 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 配置。