YouTube Transcript Remote MCP Server

Der erste Remote Model Context Protocol (MCP)-Server, der es Claude AI ermöglicht, Transkripte aus YouTube-Videos zu extrahieren. Dieser Server bietet Benutzern auf jeder Plattform, einschließlich mobiler Geräte, Zugriff ohne Einrichtung.

🌟 Funktionen

• Keine lokale Einrichtung: Keine Installation erforderlich – funktioniert direkt aus der Cloud

• Universeller Zugriff: Funktioniert auf Desktop-, Mobil- und Webversionen von Claude

• Intelligentes Caching: Effizientes Caching-System mit Cloudflare KV für schnelle Antworten

• Mehrsprachige Unterstützung: Transkripte in verschiedenen Sprachen extrahieren

• Fehlerbehandlung: Robuste Fehlerbehandlung mit benutzerfreundlichen Meldungen

• Analysen: Integrierte Anfrageverfolgung und Nutzungsanalysen

• URL-Flexibilität: Verarbeitet alle YouTube-URL-Formate (youtube.com, youtu.be, m.youtube.com usw.)

Related MCP server: ytt-mcp

🚀 Schnellstart

Option 1: Verwenden Sie unseren gehosteten Server (empfohlen)

Der einfachste Weg, loszulegen – fügen Sie einfach unseren öffentlichen Server zu Ihrem Claude Desktop hinzu:

Für Claude Desktop-Benutzer

1. Öffnen Sie die Claude Desktop-Einstellungen

   • Klicken Sie in der Menüleiste auf „Claude" → „Einstellungen"

   • Navigieren Sie zum Tab „Entwickler"

   • Klicken Sie auf „Konfiguration bearbeiten"

2. Fügen Sie die MCP-Server-Konfiguration hinzu

   Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

   {
     "mcpServers": {
       "youtube-transcript": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://youtube-transcript-mcp.ergut.workers.dev/sse"
         ]
       }
     }
   }

3. Starten Sie Claude Desktop neu

   Speichern Sie die Konfigurationsdatei und starten Sie Claude Desktop neu, um den Server zu laden.

4. Installation überprüfen

   Suchen Sie nach dem Werkzeugsymbol (🔧) in der Chat-Oberfläche. Sie sollten das Werkzeug get_transcript verfügbar sehen.

Option 2: Eigenen Server bereitstellen

Möchten Sie Ihre eigene Instanz betreiben? Stellen Sie sie mit einem Klick auf Cloudflare Workers bereit:

Oder manuell:

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run deploy

Für andere MCP-Clients

Der Server unterstützt das Standard-MCP-Protokoll und kann mit jedem kompatiblen Client verwendet werden:

• Öffentliche Server-URL: https://youtube-transcript-mcp.ergut.workers.dev/sse

• Transport: Server-Sent Events (SSE) oder HTTP

• Authentifizierung: Keine erforderlich (öffentlicher Server)

📖 Verwendungsbeispiele

Grundlegende Transkriptextraktion

Extract the transcript from this YouTube video: https://www.youtube.com/watch?v=dQw4w9WgXcQ

Mehrsprachige Unterstützung

Can you get the transcript of this video in Turkish: https://youtu.be/VIDEO_ID

Extract the Spanish transcript from: https://www.youtube.com/watch?v=VIDEO_ID

Unterstützte URL-Formate

Der Server verarbeitet automatisch alle YouTube-URL-Formate:

• https://www.youtube.com/watch?v=VIDEO_ID

• https://youtu.be/VIDEO_ID

• https://m.youtube.com/watch?v=VIDEO_ID

• https://www.youtube.com/live/VIDEO_ID

• https://www.youtube.com/embed/VIDEO_ID

• https://www.youtube.com/shorts/VIDEO_ID

• Internationale Domains (youtube.co.uk, youtube.de usw.)

Alle Tracking-Parameter (wie ?si=, &t= usw.) werden automatisch entfernt.

🛠 Verfügbare Werkzeuge

get_transcript

Extrahiert das Transkript aus einer YouTube-Video-URL.

Parameter:

• url (erforderlich): YouTube-Video-URL in jedem Format

• language (optional): Sprachcode für das Transkript (z. B. 'en', 'es', 'fr'). Standard ist 'en'.

Beispielverwendung:

{
  "name": "get_transcript",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }
}

🔧 Erweiterte Konfiguration

Debug-Protokollierung

So aktivieren Sie die detaillierte Protokollierung zur Fehlerbehebung:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/sse",
        "--debug"
      ]
    }
  }
}

Debug-Protokolle werden in ~/.mcp-auth/{server_hash}_debug.log erstellt.

Nur HTTP-Transport

So erzwingen Sie HTTP-Transport anstelle von SSE:

{
  "mcpServers": {
    "youtube-transcript": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://youtube-transcript-mcp.ergut.workers.dev/mcp",
        "--transport",
        "http-only"
      ]
    }
  }
}

📊 Serverinformationen

• Hosting: Cloudflare Workers

• Caching: Cloudflare KV mit 7-Tage-Cache für erfolgreiche Transkripte

• Ratenbegrenzung: Integrierte Wiederholungslogik mit exponentiellem Backoff

• Verfügbarkeit: 99,9 %+ Verfügbarkeit über das globale Netzwerk von Cloudflare

• Antwortzeit: Typischerweise <3 Sekunden für gecachte Inhalte, <10 Sekunden für neue Anfragen

🚨 Fehlerbehandlung

Der Server liefert klare Fehlermeldungen für häufige Probleme:

• "Ungültige YouTube-URL angegeben": Das URL-Format wird nicht erkannt

• "Kein Transkript für dieses Video verfügbar": Das Video hat keine Untertitel/Transkript

• "Video nicht gefunden oder privat": Das Video ist privat, gelöscht oder existiert nicht

• "Dienst vorübergehend ausgelastet, versuchen Sie es in ein paar Minuten erneut": Ratenbegrenzung von YouTube

• "Transkripte sind für dieses Video deaktiviert": Der Ersteller hat Untertitel deaktiviert

🌍 Sprachunterstützung

Der Server unterstützt jede Sprache, für die YouTube Transkripte bereitstellt. Häufige Sprachcodes:

• en – Englisch (Standard)

• tr – Türkisch

• es – Spanisch

• fr – Französisch

• de – Deutsch

• it – Italienisch

• pt – Portugiesisch

• ja – Japanisch

• ko – Koreanisch

• zh – Chinesisch

🔒 Datenschutz & Sicherheit

• Keine Authentifizierung erforderlich: Öffentlicher Server für einfache Nutzung

• Keine Datenspeicherung: Transkripte werden nur vorübergehend für die Leistung zwischengespeichert

• Keine persönlichen Informationen: Es werden nur YouTube-Video-IDs und Transkripte verarbeitet

• Nur HTTPS: Alle Kommunikationen sind verschlüsselt

• CORS aktiviert: Unterstützt webbasierte MCP-Clients

🚀 API-Endpunkte

Für Entwickler, die direkt integrieren möchten:

HTTP POST /mcp

Standard-MCP-JSON-RPC-Endpunkt für die direkte Integration.

Server-Sent Events /sse

MCP-SSE-Transportendpunkt für Echtzeitkommunikation.

Info /

Serverinformations- und Statusendpunkt.

Beispiel für einen direkten API-Aufruf:

curl -X POST https://youtube-transcript-mcp.ergut.workers.dev/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_transcript",
      "arguments": {
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "language": "en"
      }
    }
  }'

🐛 Fehlerbehebung

Häufige Probleme

1. „Verbindungsfehler" in Claude Desktop

   • Stellen Sie sicher, dass Sie die neueste Claude Desktop-Version haben

   • Überprüfen Sie, ob mcp-remote korrekt konfiguriert ist

   • Versuchen Sie, das Flag --debug hinzuzufügen, um detaillierte Protokolle zu sehen

2. „Konnte keine Verbindung zum MCP-Server herstellen"

   • Überprüfen Sie Ihre Internetverbindung

   • Stellen Sie sicher, dass die Server-URL korrekt ist

   • Starten Sie Claude Desktop nach Konfigurationsänderungen neu

3. Kein Transkript zurückgegeben

   • Überprüfen Sie, ob die YouTube-URL gültig und erreichbar ist

   • Prüfen Sie, ob das Video Untertitel aktiviert hat

   • Versuchen Sie einen anderen Sprachcode, falls verfügbar

Hilfe erhalten

• Protokolle prüfen: Suchen Sie in ~/.mcp-auth/ nach Debug-Protokollen

• Direkte Verbindung testen: Verwenden Sie npx -p mcp-remote@latest mcp-remote-client https://youtube-transcript-mcp.ergut.workers.dev/sse

• Serverstatus überprüfen: Besuchen Sie https://youtube-transcript-mcp.ergut.workers.dev/

• Ein Problem melden: GitHub Issues

🤝 Mitwirken

Dies ist ein Open-Source-Projekt. Beiträge sind willkommen!

• Probleme melden: Einen Fehler gefunden? Bitte öffnen Sie ein Issue

• Feature-Anfragen: Haben Sie Ideen für Verbesserungen? Lassen Sie es uns wissen!

• Code-Beiträge: Pull-Requests für Verbesserungen sind willkommen

Entwicklungsumgebung

git clone https://github.com/ergut/youtube-transcript-mcp
cd youtube-transcript-mcp
npm install
npm run dev

📜 Lizenz

Dieses Projekt ist Open Source und unter der MIT-Lizenz verfügbar.

🙏 Danksagungen

• Erstellt mit dem Model Context Protocol von Anthropic

• Gehostet auf Cloudflare Workers

• Verwendet die Bibliothek youtube-transcript

• Inspiriert von der MCP-Community und bestehenden lokalen Transkript-Servern

Bereit, Claude mit der YouTube-Transkriptextraktion zu erweitern? Fügen Sie diesen Server zu Ihrer Claude Desktop-Konfiguration hinzu und extrahieren Sie sofort Transkripte aus jedem YouTube-Video! 🎉