ElevenLabs

Offizieller ElevenLabs Model Context Protocol (MCP) Server, der die Interaktion mit leistungsstarken Text-to-Speech- und Audioverarbeitungs-APIs ermöglicht. Dieser Server erlaubt MCP-Clients wie Claude Desktop, Cursor, Windsurf, OpenAI Agents und anderen, Sprache zu erzeugen, Stimmen zu klonen, Audio zu transkribieren und mehr.

Schnellstart mit Claude Desktop

1. Holen Sie sich Ihren API-Schlüssel von ElevenLabs. Es gibt eine kostenlose Stufe mit 10.000 Credits pro Monat.
2. Installieren Sie uv (Python-Paketmanager), installieren Sie mit curl -LsSf https://astral.sh/uv/install.sh | sh oder sehen Sie sich das uv Repo für weitere Installationsmethoden an.
3. Gehen Sie zu Claude > Einstellungen > Entwickler > Konfiguration bearbeiten > claude_desktop_config.json und fügen Sie Folgendes ein:

{
  "mcpServers": {
    "ElevenLabs": {
      "command": "uvx",
      "args": ["elevenlabs-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "<insert-your-api-key-here>"
      }
    }
  }
}

Wenn Sie Windows verwenden, müssen Sie den "Entwicklermodus" in Claude Desktop aktivieren, um den MCP-Server verwenden zu können. Klicken Sie im Hamburger-Menü oben links auf "Hilfe" und wählen Sie "Entwicklermodus aktivieren".

Andere MCP-Clients

Für andere Clients wie Cursor und Windsurf führen Sie Folgendes aus:

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print um die Konfiguration zu erhalten. Fügen Sie sie in das entsprechende Konfigurationsverzeichnis ein, das von Ihrem MCP-Client angegeben wird.

Das war's. Ihr MCP-Client kann jetzt über diese Tools mit ElevenLabs interagieren:

Beispielverwendung

⚠️ Warnung: Für die Verwendung dieser Tools sind ElevenLabs-Credits erforderlich.

Versuchen Sie, Claude zu fragen:

• "Erstelle einen KI-Agenten, der wie ein Film-Noir-Detektiv spricht und Fragen zu klassischen Filmen beantworten kann"
• "Generiere drei Stimmvariationen für einen weisen, uralten Drachencharakter, dann wähle ich meine Lieblingsstimme aus, um sie zu meiner Stimmbibliothek hinzuzufügen"
• "Wandle diese Aufnahme meiner Stimme so um, dass sie wie ein mittelalterlicher Ritter klingt"
• "Erstelle eine Klangkulisse eines Gewitters in einem dichten Dschungel, in dem Tiere auf das Wetter reagieren"
• "Wandle diese Sprache in Text um, identifiziere verschiedene Sprecher und konvertiere sie dann mit einzigartigen Stimmen für jede Person zurück"

Optionale Funktionen

Dateiausgabekonfiguration

Sie können konfigurieren, wie der MCP-Server Dateiausgaben verarbeitet, indem Sie diese Umgebungsvariablen in Ihrer claude_desktop_config.json verwenden:

• ELEVENLABS_MCP_BASE_PATH: Geben Sie den Basispfad für Dateivorgänge an (Standard: ~/Desktop). Dieses Verzeichnis ist auch die Sicherheitsgrenze für Eingabe-Dateien: Jeder Pfad, der an ein Tool übergeben wird, das eine lokale Datei liest (z. B. speech_to_text, isolate_audio, speech_to_speech, video_to_music, upload_music_for_inpainting), muss innerhalb dieses Verzeichnisses aufgelöst werden, unabhängig davon, ob er als absoluter oder relativer Pfad angegeben ist. Pfade außerhalb davon — selbst wenn sie absolut und zuvor akzeptiert wurden — werden abgelehnt. Setzen Sie dies auf ein Verzeichnis, das alles enthält, was Sie lesen oder schreiben müssen.
• ELEVENLABS_MCP_OUTPUT_MODE: Steuern Sie, wie generierte Dateien zurückgegeben werden (Standard: files)

Ausgabemodi

Die ELEVENLABS_MCP_OUTPUT_MODE-Umgebungsvariable unterstützt drei Modi:

1. files (Standard): Dateien auf der Festplatte speichern und Dateipfade zurückgeben

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "files"
   }
   

2. resources: Dateien als MCP-Ressourcen zurückgeben; Binärdaten werden base64-kodiert, Text wird als UTF-8-Text zurückgegeben

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "resources"
   }
   

3. both: Dateien auf der Festplatte speichern UND als MCP-Ressourcen zurückgeben

   "env": {
     "ELEVENLABS_API_KEY": "your-api-key",
     "ELEVENLABS_MCP_OUTPUT_MODE": "both"
   }
   

Vorteile des Ressourcenmodus:

• Dateien werden direkt in der MCP-Antwort als base64-kodierte Daten zurückgegeben
• Kein Festplatten-I/O erforderlich – nützlich für containerisierte oder serverlose Umgebungen
• MCP-Clients können sofort auf Dateiinhalte zugreifen, ohne Dateisystemzugriff
• Im both-Modus können Ressourcen später über das elevenlabs://filename-URI-Muster abgerufen werden

Anwendungsfälle:

• files: Traditionelle dateibasierte Arbeitsabläufe, lokale Entwicklung
• resources: Cloud-Umgebungen, MCP-Clients ohne Dateisystemzugriff
• both: Maximale Flexibilität, Caching und Szenarien zur Ressourcenfreigabe

Data-Residency-Schlüssel

Sie können die Data-Residency-Region mit der ELEVENLABS_API_RESIDENCY-Umgebungsvariable angeben. Standard ist "us".

Hinweis: Data-Residency ist ein Enterprise-Feature. Weitere Details finden Sie in der Dokumentation.

Mitwirken

Wenn Sie mitwirken oder aus dem Quellcode ausführen möchten:

1. Klonen Sie das Repository:

git clone https://github.com/elevenlabs/elevenlabs-mcp
cd elevenlabs-mcp

2. Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten mit uv:

uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"

3. Kopieren Sie .env.example nach .env und fügen Sie Ihren ElevenLabs-API-Schlüssel hinzu:

cp .env.example .env
# Edit .env and add your API key

4. Führen Sie die Tests aus, um sicherzustellen, dass alles funktioniert:

./scripts/test.sh
# Or with options
./scripts/test.sh --verbose --fail-fast

5. Installieren Sie den Server in Claude Desktop: mcp install elevenlabs_mcp/server.py

6. Debuggen und testen Sie lokal mit MCP Inspector: mcp dev elevenlabs_mcp/server.py

Fehlerbehebung

Protokolle bei der Ausführung mit Claude Desktop finden Sie unter:

• Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

Timeouts bei bestimmten Tools

Bestimmte ElevenLabs-API-Vorgänge, wie Stimmen-Design und Audio-Isolation, können lange dauern. Wenn Sie den MCP Inspector im Entwicklermodus verwenden, können Timeout-Fehler auftreten, obwohl das Tool seine beabsichtigte Aufgabe erfüllt.

Dies sollte bei der Verwendung eines Clients wie Claude nicht auftreten.

MCP ElevenLabs: spawn uvx ENOENT

Wenn Sie den Fehler "MCP ElevenLabs: spawn uvx ENOENT" erhalten, bestätigen Sie den absoluten Pfad, indem Sie diesen Befehl in Ihrem Terminal ausführen:

which uvx

Sobald Sie den absoluten Pfad erhalten (z. B. /usr/local/bin/uvx), aktualisieren Sie Ihre Konfiguration, um diesen Pfad zu verwenden (z. B. "command": "/usr/local/bin/uvx"). Dadurch wird sichergestellt, dass auf das korrekte ausführbare Programm verwiesen wird.