Zonos TTS MCP

🚀 Zonos TTS 與 MCP 集成

本項目實現了 Zonos TTS 的 Model Context Protocol（MCP）集成，讓 Claude 能夠直接生成語音，為語音交互帶來更便捷的體驗。

🚀 快速開始

安裝說明

通過 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"
)

✨ 主要特性

• 文本到語音（TTS）：通過 Claude 實現文本到語音的轉換。
• 多種情感支持：支持多種情感，如中立、快樂、悲傷、憤怒等。
• 多語言支持：支持多種語言。
• 音頻播放：通過 PulseAudio 正確播放音頻。

📦 安裝指南

通過 Smithery 安裝

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 的配置文件： 編輯 ~/.config/claude/config.json，在 mcpServers 部分添加：

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

替換 /path/to/your/zonos-mcp 為實際路徑。

💻 使用示例

基礎用法

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