Zonos TTS MCP Linux

🚀 Linux用Zonos TTS MCP

このプロジェクトは、Zonos TTS用のModel Context Protocol（MCP）を統合し、Linuxシステム上でClaudeが直接音声を生成できるようにします。

🚀 クイックスタート

このプロジェクトは、Claude AIがZonos TTSを通じてテキストを音声に変換することを可能にします。Model Context Protocol（MCP）を使用しており、Claudeは複数の言語と感情を持つ自然な音声を生成できます。

✨ 主な機能

• Claudeを通じたテキスト読み上げ
• 複数の感情（中性、喜び、悲しみ、怒り）のサポート
• 多言語サポート
• PulseAudio/PipeWireを通じた正しい音声再生
• Linux環境との互換性

📦 インストール

システム要件

• Node.js
• PulseAudioまたはPipeWireとその互換層
• 稼働中のZonos APIインスタンス（PhialsBasement/zonos-api）
• 正常に動作するオーディオ出力デバイス
• Claudeデスクトップアプリケーション

インストール手順

Smitheryを通じたインストール

Claude Desktopに修正されていないオリジナルバージョンのZonos TTSを自動的にインストールするには、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. 音声再生の未終了問題を修正します。

詳細なトラブルシューティング情報

完全なREADMEファイルと詳細情報については、GitHubを参照してください。

💻 使用例

基本的な使用法

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

📄 ライセンス

このプロジェクトの使用と配布は、ライセンス契約に従う必要があります。