Fish Audio TTS を音声モード MCP に接続します

音声モードは、Claude Code と他の MCP クライアントに双方向の音声会話を追加します。 Fish Audio OpenAI 互換エンドポイントを TTS サービス リストに追加します。

環境変数を設定する

これらの値を MCP サーバーの env ブロックに追加します。

{
  "OPENAI_API_KEY": "YOUR_API_KEY",
  "VOICEMODE_TTS_BASE_URLS": "https://fishaudio.org/v1",
  "VOICEMODE_TTS_MODEL": "fishaudio-s21pro-flash",
  "VOICEMODE_TTS_VOICE": "00a1b221-6137-4b73-ad62-b0cbce134167"
}

あるいは、~/.voicemode/voicemode.env に入れます。

export OPENAI_API_KEY="YOUR_API_KEY"
export VOICEMODE_TTS_BASE_URLS="https://fishaudio.org/v1"
export VOICEMODE_TTS_MODEL="fishaudio-s21pro-flash"
export VOICEMODE_TTS_VOICE="00a1b221-6137-4b73-ad62-b0cbce134167"

従来の TTS_BASE_URL、TTS_MODEL、および TTS_VOICE 変数は引き続きサポートされますが、新しい構成では VOICEMODE_ 名を使用する必要があります。

音声をテストして変更する

MCP クライアントを再起動して、音声モード サーバがその環境をリロードするようにします。短い音声会話を開始し、テスト音声を好みの 音声 ID に置き換えます。

複数の TTS URL が構成されている場合、音声モードはフォールバック サービスを順番に試行できます。トラブルシューティング中は、https://fishaudio.org/v1 のみを保持してください。

トラブルシューティング

• 別のサービスが使用されています: テスト中に VOICEMODE_TTS_BASE_URLS から他のエントリを削除します。
• API キーがありません: MCP サーバーを起動するプロセスで変数が使用できることを確認してください。
• 無効なモデルまたは音声: OpenAI デフォルトではなく、Fish Audio ID を使用してください。
• 401/402: キーと API クレジット残高を確認します。

関連ドキュメント

• API認証
• OpenAI互換TTS
• ボイスモード環境リファレンス