Zonos TTS MCP for Linux

Linux 向け Zonos TTS MCP

Claude が Linux システム上で直接音声を生成できるようにする、Zonos TTS の Model Context Protocol 統合です。

概要

このプロジェクトでは、Zonos TTS システムを使用して Claude AI にテキスト読み上げ機能を提供します。この統合では Model Context Protocol（MCP）を使用し、Claude が複数の言語や感情で自然な音声を生成できるようにします。

主な機能

• Claude を通じたテキスト読み上げ
• 複数の感情に対応（ニュートラル、喜び、悲しみ、怒り）
• 複数の言語に対応
• PulseAudio/PipeWire による適切な音声再生
• Linux 環境に対応

必要条件

• Node.js
• PulseAudio 互換レイヤーを備えた PulseAudio または PipeWire
• Zonos API の実行中のインスタンス（PhialsBasement/zonos-api）
• 正常に動作する音声出力デバイス
• Claude デスクトップアプリ

セットアップ

Smithery 経由でのインストール

Smithery 経由で、Claude デスクトップ向けの Zonos TTS 統合のオリジナルの未変更バージョンを自動的にインストールするには、次の手順に従います。

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

GPU 最適化を適用した Linux 向けの手動インストール

1. API 実装を含む Zonos 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. JSON の解析エラーを防ぐため、コンソール出力を標準出力ではなくログファイル（/tmp/zonos-tts-mcp.log）にリダイレクトしています。
2. パフォーマンスを向上させるために、TTS パラメーターを最適化しています。

パフォーマンスの最適化

このフォークには、GPU の負荷を軽減するためのパフォーマンス最適化が含まれています。

• より効率的なサンプリングパラメーター（top_p と min_p）を使用
• MCP 通信への干渉を防ぐため、ログ処理を改善

Claude での使用

設定が完了すると、Claude は speak_response ツールを使用できます。

speak_response(
    text="Your text here",
    language="en-us",  # optional, defaults to en-us
    emotion="happy"    # optional: "neutral", "happy", "sad", "angry"
)

クレジット

このプロジェクトは、Linux との互換性とパフォーマンスを向上させるために改変した PhialsBasement/zonos-tts-mcp です。

Zonos TTS システムは Zyphra が開発しており、同社の Zonos API を通じて利用できます。

ライセンス

ライセンス情報については、元のプロジェクトを参照してください。

メモ

• Zonos API サーバーとこの MCP サーバーの両方が実行されていることを確認してください
• 音声を再生するには、PulseAudio/PipeWire が適切に設定されている必要があります
• GPU 使用率が高い場合は、サーバーコード内の TTS パラメーターを調整してください