elevenlabs-mcp

Schnelleinstieg mit Claude Desktop

1. Holen Sie sich Ihren API-Schlüssel von ElevenLabs. Es gibt einen kostenlosen Tarif mit 10.000 Credits pro Monat.

2. Installieren Sie uv (Python-Paketmanager), installieren Sie es 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 > Settings > Developer > Edit Config > claude_desktop_config.json, um Folgendes hinzuzufügen:

{
  "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 nutzen zu können. Klicken Sie im Hamburger-Menü oben links auf "Help" und wählen Sie "Enable Developer Mode".

Related MCP server: ElevenLabs MCP Server

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 diese in das entsprechende Konfigurationsverzeichnis ein, das von Ihrem MCP-Client angegeben wird.

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

Beispielanwendung

⚠️ Warnung: ElevenLabs-Credits werden benötigt, um diese Tools zu verwenden.

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 meiner Stimmbibliothek hinzuzufügen"

• "Wandle diese Aufnahme meiner Stimme so um, dass sie wie ein mittelalterlicher Ritter klingt"

• "Erstelle eine Klanglandschaft eines Gewitters in einem dichten Dschungel, in dem Tiere auf das Wetter reagieren"

• "Wandle diese Sprache in Text um, identifiziere verschiedene Sprecher und wandle sie dann mit einzigartigen Stimmen für jede Person wieder um"

Optionale Funktionen

Konfiguration der Dateiausgabe

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

• ELEVENLABS_MCP_BASE_PATH: Geben Sie den Basispfad für Dateioperationen mit relativen Pfaden an (Standard: ~/Desktop)

• ELEVENLABS_MCP_OUTPUT_MODE: Steuern Sie, wie generierte Dateien zurückgegeben werden (Standard: files)

Ausgabemodi

Die Umgebungsvariable ELEVENLABS_MCP_OUTPUT_MODE unterstützt drei Modi:

1. files (Standard): Speichert Dateien auf der Festplatte und gibt Dateipfade zurück

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

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

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

3. both: Speichert Dateien auf der Festplatte UND gibt sie als MCP-Ressourcen zurück

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

Vorteile des Ressourcen-Modus:

• 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 URI-Muster elevenlabs://filename abgerufen werden

Anwendungsfälle:

• files: Traditionelle dateibasierte Workflows, lokale Entwicklung

• resources: Cloud-Umgebungen, MCP-Clients ohne Dateisystemzugriff

• both: Maximale Flexibilität, Caching und Szenarien zur Ressourcenfreigabe

Datenresidenz-Schlüssel

Sie können die Region für die Datenresidenz mit der Umgebungsvariable ELEVENLABS_API_RESIDENCY angeben. Standard ist "us".

Hinweis: Datenresidenz ist eine reine Enterprise-Funktion. 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 dem 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 der Verwendung bestimmter Tools

Bestimmte ElevenLabs API-Operationen, wie Voice Design und Audio-Isolation, können lange dauern. Bei der Verwendung des MCP-Inspectors im Entwicklermodus erhalten Sie möglicherweise Timeout-Fehler, 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 haben (z. B. /usr/local/bin/uvx), aktualisieren Sie Ihre Konfiguration, um diesen Pfad zu verwenden (z. B. "command": "/usr/local/bin/uvx"). Dies stellt sicher, dass auf die richtige ausführbare Datei verwiesen wird.