TwelveLabs MCP Server

Dieses Projekt steht in keiner Verbindung zu TwelveLabs (der Video-Verständnis-Plattform). Es ist ein MCP-Server für die ElevenLabs Conversational AI API – Sprachagenten, Wissensdatenbanken, Konversationen und TTS. Der Name „TwelveLabs“ ist nur der Projekt-Codename.

Ein erweiterter MCP-Server (Model Context Protocol), der jedem kompatiblen MCP-Client direkten Zugriff auf die ElevenLabs Conversational AI API bietet – einschließlich Funktionen, die der offizielle ElevenLabs-MCP-Connector nicht bereitstellt.

Was dieser Server abdeckt

• Agents – Liste, vollständige Konfiguration (inkl. LLM-Modell und Temperatur), Prompt/Einstellungen aktualisieren, Webhooks und Datei-Uploads verwalten

• Wissensdatenbank – Liste, vollständigen Inhalt lesen, Text-/URL-Dokumente hinzufügen, Dokumente löschen

• Konversationen – Verlauf filtern und taggen, Transkripte einsehen, Post-Call-Analyse/-Bewertungen erneut ausführen

• Stimmen – verfügbare Stimmen auflisten und durchsuchen

Related MCP server: elevenlabs-mcp-experiments

Voraussetzungen

• Node.js >= 18

• ElevenLabs-API-Schlüssel – einen erhalten Sie unter elevenlabs.io

Schnellstart

Option A: npx (kein Klonen nötig)

ELEVENLABS_API_KEY=your-key npx twelvelabs-mcp-server

Option B: Klonen und bauen

git clone https://github.com/micro-JAY/twelvelabs-mcp-server.git
cd twelvelabs-mcp-server
npm install --include=dev
npm run build

Einen MCP-Client verbinden

Fügen Sie einen entsprechenden Server-Eintrag zur Konfiguration Ihres MCP-Clients hinzu. Der Speicherort der Konfigurationsdatei und die umgebende Syntax variieren je nach Client; dies ist die Standarddefinition für einen stdio-Server:

{
  "mcpServers": {
    "twelvelabs": {
      "command": "node",
      "args": ["/path/to/twelvelabs-mcp-server/dist/index.js"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Starten Sie Ihren MCP-Client neu oder verbinden Sie ihn erneut. Sie sollten twelvelabs in der Liste der verfügbaren Tools sehen.

Verwendung

Bitten Sie Ihren MCP-fähigen Assistenten, die Tools zu verwenden, zum Beispiel:

„Liste meine Agents“ „Hole die vollständige Konfiguration für agent_1001kjbh14xce5kbreh55ydf4rae“ „Zeig mir die letzten 10 Konversationen für diesen Agenten“ „Hole das Transkript und die Analyse für conversation_xyz“

Kompatibilität

Dieser Server funktioniert mit MCP-Clients, die den stdio-Transport unterstützen und es Ihnen ermöglichen, Umgebungsvariablen für einen lokalen Serverprozess zu konfigurieren. Clients, die nur entfernte HTTP-MCP-Server unterstützen, benötigen eine kompatible stdio-Brücke oder einen Proxy.

Tool-Referenz

Agent-Tools

Wissensdatenbank-Tools

Konversations-Tools

Stimm-Tools

Sicherheit

• Eingabevalidierung – alle Tool-Parameter werden vor dem API-Aufruf mit Zod-Schemas validiert

• HTTPS-Erzwingung – Webhook-URLs werden validiert, um nur HTTPS zu verwenden

• Schutz vor Pfad-Traversal – Dokument- und Agenten-IDs werden bereinigt, um Pfad-Traversal zu verhindern

• Fehlerbereinigung – interne Fehler werden abgefangen und als sichere MCP-Fehlerantworten zurückgegeben; rohe Stack-Traces werden dem Client nie offengelegt

Entwicklung

npm run dev   # watch mode with tsx -- auto-reloads on file changes
npm run build # compile to dist/

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feat/my-feature)

3. Committen Sie Ihre Änderungen (git commit -m 'feat: add my feature')

4. Pushen Sie den Branch (git push origin feat/my-feature)

5. Öffnen Sie einen Pull Request

Lizenz

MIT – siehe LICENSE für Details.

Architektur-Hinweis

Alle Tools verwenden eine einzige Axios-Client-Instanz (src/client.ts), die beim Start mit ELEVENLABS_API_KEY initialisiert wird. Tool-Implementierungen befinden sich in src/tools/ – eine Datei pro Domäne – und werden in src/index.ts auf dem McpServer registriert. Der Server kommuniziert über den stdio-Transport (stdin/stdout), weshalb das gesamte Debug-Logging console.error (stderr) verwendet, nicht console.log.