Fish Audio Docs
IntegrationsleitfädenIntegrationen von Drittanbietern

MCP-Setup für den Sprachmodus

Konfigurieren Sie Fish Audio als OpenAI-kompatiblen TTS-Dienst für Sprachmodus und MCP-Clients wie Claude Code.

Verbinden Sie Fish Audio TTS mit dem Sprachmodus-MCP

Der Sprachmodus fügt Claude Code und anderen MCP-Clients bidirektionale Sprachgespräche hinzu. Fügen Sie den Fish Audio OpenAI-kompatiblen Endpunkt zu seiner TTS-Dienstliste hinzu.

Umgebungsvariablen konfigurieren

Fügen Sie diese Werte zum env-Block des MCP-Servers hinzu:

{
  "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"
}

Alternativ können Sie sie auch in ~/.voicemode/voicemode.env einfügen:

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"

Die alten Variablen TTS_BASE_URL, TTS_MODEL und TTS_VOICE werden weiterhin unterstützt, neue Konfigurationen sollten jedoch die Namen VOICEMODE_ verwenden.

Testen und ändern Sie die Stimme

Starten Sie den MCP-Client neu, damit der Sprachmodus-Server seine Umgebung neu lädt. Starten Sie ein kurzes Sprachgespräch und ersetzen Sie dann die Teststimme durch Ihre bevorzugte Sprach-ID.

Wenn mehrere TTS-URLs konfiguriert sind, kann der Sprachmodus nacheinander Fallback-Dienste ausprobieren. Behalten Sie während der Fehlerbehebung nur https://fishaudio.org/v1 bei.

Fehlerbehebung

  • Ein anderer Dienst wird verwendet: Entfernen Sie während des Tests andere Einträge aus VOICEMODE_TTS_BASE_URLS.
  • API-Schlüssel fehlt: Stellen Sie sicher, dass die Variable für den Prozess verfügbar ist, der den MCP-Server startet.
  • Ungültiges Modell oder ungültige Stimme: Verwenden Sie Fish Audio-IDs anstelle der OpenAI-Standardwerte.
  • 401/402: Überprüfen Sie den Schlüssel und das API-Guthaben.

Verwandte Dokumentation