Zonos TTS MCP Linux

🚀 Zonos TTS MCP for Linux

一個為Zonos TTS設計的Model Context Protocol（MCP）集成，允許Claude在Linux系統上直接生成語音。本項目使Claude AI能夠藉助Zonos TTS實現文本轉語音功能，讓你在Linux環境下也能輕鬆體驗語音交互的魅力。

🚀 快速開始

該項目使Claude AI能夠通過Zonos TTS實現文本轉語音功能。該集成使用了Model Context Protocol（MCP），使得Claude可以生成多種語言和情感的自然流暢語音。

✨ 主要特性

• 通過Claude進行文本轉語音
• 支持多種情感（中性、快樂、悲傷、生氣）
• 多語言支持
• 通過PulseAudio/PipeWire正確播放音頻
• 兼容Linux環境

📦 安裝指南

系統要求

• Node.js
• PulseAudio或PipeWire及其兼容層
• 正在運行的Zonos API實例（PhialsBasement/zonos-api）
• 正常工作的音頻輸出設備
• Claude桌面應用程序

安裝步驟

通過Smithery安裝

要自動安裝未經修改的原始版本的Zonos TTS集成Claude Desktop，可通過Smithery運行以下命令：

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. 將控制檯輸出重定向到stdout，以便在出現問題時更容易調試。
2. 修復了音頻播放中未終止的問題。

更多故障排除信息

請訪問GitHub查看完整的README文件和更多詳細信息。

使用說明

Claude可以通過以下命令調用：

await window.zilASA?.api("tts/speak", {
  text: "Hello World",
  modelId: "your-model-id",
});

參數設置示例

• 文本：要生成語音的文本內容。
• 情感（可選）：設置語音的情感，例如happy、sad、angry或calm。
• 語言（可選）：指定目標語言，如en-US或zh-CN。

更多詳細信息

請訪問GitHub查看完整的文檔和更多示例。

📄 許可證

該項目的使用和分發需遵守其許可證協議。

🔗 項目來源

• GitHub - Zonos TTS MCP for Linux