Skip to main content
Glama
Youtube MCP

Youtube MCP

by MSKKK007

YouTube MCP Connector für Claude.ai

Produktionsreifer Remote-MCP-Server, der es Claude.ai ermöglicht, über HTTPS schreibgeschützte YouTube-Tools zu nutzen:

  • search_videos

  • get_trending_videos

  • get_channel_videos

  • get_video_details

  • get_engagement_stats

  • get_transcript

  • search_transcript

Der Dienst verwendet die offizielle YouTube Data API v3 für Suche, Metadaten, Trend-Videos und Kanal-Uploads. Der Transkriptabruf erfolgt nach dem Best-Effort-Prinzip: Zuerst werden öffentliche InnerTube-Untertitelspuren probiert, danach die Untertitelermittlung über die YouTube-Watch-Seite. Er umgeht keine CAPTCHAs, Sperren oder Rate-Limits.

Lokale Einrichtung

npm install
cp .env.example .env

Setzen Sie mindestens:

YOUTUBE_API_KEY=your_google_api_key
AUTH_MODE=none

Lokal ausführen:

npm run dev

Health Checks:

curl http://localhost:3000/health
curl http://localhost:3000/ready

Erstellen und testen:

npm test
npm run build

Related MCP server: YouTube MCP Server

Produktionsumgebung

Minimale Railway-Testvariablen:

YOUTUBE_API_KEY=...
AUTH_MODE=none

Redis wird empfohlen, aber die App kann auch ohne Redis starten und verwendet dann einen prozessinternen No-op-Cache.

Vollständige Produktionsvariablen:

NODE_ENV=production
YOUTUBE_API_KEY=...
AUTH_MODE=oauth
AUTH_ISSUER=https://YOUR_AUTH0_DOMAIN/
AUTH_AUDIENCE=https://youtube-claude-mcp
AUTH_JWKS_URL=https://YOUR_AUTH0_DOMAIN/.well-known/jwks.json
AUTH_REQUIRED_SCOPE=youtube:read
REDIS_URL=...

Standard-Cache-TTLs:

TRANSCRIPT_CACHE_TTL_SECONDS=604800
VIDEO_DETAILS_CACHE_TTL_SECONDS=900
TRENDING_CACHE_TTL_SECONDS=600
CHANNEL_VIDEOS_CACHE_TTL_SECONDS=600

Auth0-Einrichtung

  1. Erstellen Sie eine Auth0-API oder verwenden Sie eine vorhandene wieder.

  2. Setzen Sie die API-Kennung auf denselben Wert wie AUTH_AUDIENCE.

  3. Fügen Sie den Scope youtube:read hinzu.

  4. Verwenden Sie die Auth0-Issuer-URL als AUTH_ISSUER.

  5. Verwenden Sie den JWKS-Endpunkt des Tenants als AUTH_JWKS_URL.

  6. Konfigurieren Sie die erweiterten OAuth-Einstellungen des benutzerdefinierten Connectors von Claude.ai mit den entsprechenden Auth0-Client-Daten.

Der /mcp-Endpunkt erfordert ein gültiges Authorization: Bearer <token>, wenn AUTH_MODE=oauth gesetzt ist.

Railway-Deployment

  1. Pushen Sie das Repository auf GitHub.

  2. Erstellen Sie ein Railway-Projekt aus dem GitHub-Repository.

  3. Railway sollte das eingecheckte Dockerfile über railway.json verwenden.

  4. Fügen Sie Servicevariablen hinzu:

YOUTUBE_API_KEY=...
AUTH_MODE=none
  1. Stellen Sie die Anwendung bereit und öffnen Sie /health.

  2. Fügen Sie später Railway Redis hinzu, wenn Sie gemeinsames Caching wünschen, und setzen Sie dann REDIS_URL.

  3. Wechseln Sie zu Auth0, indem Sie AUTH_MODE=oauth und die Auth0-Variablen setzen.

Render-Deployment

  1. Erstellen Sie eine Render-Redis-Instanz.

  2. Erstellen Sie einen Render-Web-Service aus diesem Repository.

  3. Wählen Sie das Docker-Deployment.

  4. Fügen Sie die Produktionsumgebungsvariablen hinzu.

  5. Stellen Sie bereit.

  6. Überprüfen Sie:

curl https://YOUR_RENDER_URL/health
curl https://YOUR_RENDER_URL/ready
curl -i https://YOUR_RENDER_URL/mcp

Ein nicht authentifizierter Aufruf von /mcp sollte 401 zurückgeben.

Claude.ai-Connector

  1. Öffnen Sie die Claude.ai-Einstellungen.

  2. Gehen Sie zu Customize, dann zu Connectors.

  3. Fügen Sie einen benutzerdefinierten Connector hinzu.

  4. Verwenden Sie:

https://YOUR_RENDER_URL/mcp
  1. Konfigurieren Sie die erweiterten OAuth-Einstellungen, wenn die Produktionsauthentifizierung aktiviert ist.

  2. Aktivieren Sie den Connector in einem Chat.

Demo-Prompts:

  • Suche auf YouTube nach 5 aktuellen MCP-Server-Tutorials.

  • Welche Videos sind gerade in Pakistan am beliebtesten?

  • Zeige die neuesten Videos von @GoogleDevelopers.

  • Ermittle Aufrufe, Likes und Dauer für diese YouTube-URL.

  • Berechne seine Engagement-Rate.

  • Rufe das Transkript ab und fasse es zusammen.

  • Wo im Transkript erwähnen sie die Authentifizierung?

Betriebshinweise

  • Beschränken und rotieren Sie den YouTube-API-Schlüssel in Google Cloud, wo dies praktikabel ist.

  • Protokollieren Sie keine API-Schlüssel, Bearer-Tokens oder vollständigen Autorisierungs-Header.

  • Suchaufrufe verbrauchen viel Quota; bevorzugen Sie, wo möglich, Kanal-Uploads und zwischengespeicherte Metadaten.

  • Redis-Ausfälle verschlechtern das Cache-Verhalten, lassen normale Tool-Aufrufe aber nicht fehlschlagen.

  • Transkriptfehler können auftreten, wenn Untertitel deaktiviert, nicht verfügbar, regionsbeschränkt oder von YouTube blockiert sind.

  • CAPTCHA- oder Bot-Block-Antworten werden als Fehler angezeigt; der Dienst versucht keine Umgehung.

Fehlerbehebung

  • Der Start schlägt mit YOUTUBE_API_KEY is required fehl: Setzen Sie den serverseitigen API-Schlüssel.

  • Der Start in der Produktion schlägt mit REDIS_URL is required fehl: Verbinden Sie Render Redis und setzen Sie dessen URL.

  • /mcp gibt 401 zurück: Das Token fehlt, ist abgelaufen, fehlerhaft oder wurde vom falschen Issuer signiert.

  • /mcp gibt 403 zurück: Das Token ist gültig, aber es fehlt der Scope youtube:read.

  • Das Transkript-Tool gibt „nicht verfügbar“ zurück: Das Video hat möglicherweise keine öffentlichen Untertitel.

  • YouTube-Quota überschritten: Warten Sie auf das Quota-Reset, beantragen Sie eine Quota-Erhöhung oder reduzieren Sie die Suchnutzung.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables YouTube integration with Claude Code, including video search, metadata retrieval, transcript fetching, channel exploration, and trending videos.
      8
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to interact with YouTube Data API for searching videos, channels, and playlists, and retrieving details and playlists.
      18 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables bringing YouTube into Claude Code for video transcripts, search, metadata, channel info, playlists, comments, trending videos, engagement analytics, chapters, SponsorBlock clean transcripts, and most-replayed heatmaps.
      18 npm
      -
    • F
      license
      A
      quality
      C
      maintenance
      Enables Claude Code to retrieve YouTube transcripts, search videos and channels, fetch metadata, playlists, comments, trending videos, engagement analytics, chapters, SponsorBlock-cleaned transcripts, and most-replayed heatmaps.
      15
      18 npm
      -