MCP yt-dlp Server

Ein Model Context Protocol (MCP)-Server zum Herunterladen von Videos und Streams mit yt-dlp. Dieser Server ermöglicht MCP-kompatiblen Clients (wie Claude Desktop) das Herunterladen von Videos von YouTube und über 1000 unterstützten Websites, das Extrahieren von Audio, das Herunterladen von Untertiteln und das Aufzeichnen von Live-Streams.

Danksagungen

Dieses Projekt basiert auf der unglaublichen Arbeit des yt-dlp-Teams. yt-dlp ist ein funktionsreicher Kommandozeilen-Audio-/Video-Downloader, der Tausende von Websites unterstützt. Weitere Informationen zu yt-dlp finden Sie im GitHub-Repository oder Wiki.

Related MCP server: MCP YouTube Downloader

Funktionen

• Video-Download: Videos von YouTube und über 1000 unterstützten Websites herunterladen

• Stream-Download: Live-Streams und HLS/m3u8-Streams aufzeichnen

• Video-Informationen: Metadaten ohne Herunterladen abrufen

• Formatliste: Alle verfügbaren Formate für ein Video auflisten

• Suche: Videos direkt über yt-dlp-Extraktoren suchen

• Audio-Extraktion: Nur Audio mit Formatkonvertierung herunterladen (MP3, M4A, WAV, FLAC)

• Untertitel: Untertitel in mehreren Sprachen herunterladen

• Playlist-Unterstützung: Vollständige oder teilweise Playlists herunterladen

Voraussetzungen

• Node.js 18+

• yt-dlp installiert und im selben Verzeichnis wie der Server verfügbar (oder im PATH)

Installationsanleitung

Schritt 1: Node.js installieren

Laden Sie Node.js 18+ von nodejs.org herunter und installieren Sie es.

Überprüfen Sie die Installation:

node --version
npm --version

Schritt 2: yt-dlp herunterladen (einfache Methode)

Wir stellen Setup-Skripte bereit, die automatisch die neueste Version von yt-dlp in das richtige Verzeichnis herunterladen.

Windows:

Doppelklicken Sie auf setup.bat oder führen Sie es in der Eingabeaufforderung aus:

setup.bat

Linux / macOS:

chmod +x setup.sh
./setup.sh

Das Skript wird:

• Ihr Betriebssystem erkennen

• Die neueste yt-dlp-Binärdatei herunterladen

• Sie im selben Verzeichnis wie den MCP-Server ablegen

• Die Installation überprüfen

Schritt 2 Alternative: Manueller Download

Wenn Sie yt-dlp lieber manuell installieren möchten:

Windows:

1. Laden Sie yt-dlp.exe von den neuesten Releases herunter

2. Platzieren Sie yt-dlp.exe im selben Verzeichnis wie den MCP-Server

macOS:

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

Linux:

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Python (alle Plattformen):

pip install yt-dlp

Weitere Installationsoptionen finden Sie in der yt-dlp-Installationsanleitung.

Schritt 3: Repository klonen

git clone https://github.com/timyee22/yt-dlp-MCP.git
cd yt-dlp-MCP

Schritt 4: Abhängigkeiten installieren

npm install

Schritt 5: MCP-Client konfigurieren

Fügen Sie den Server zu Ihrer MCP-Client-Konfiguration hinzu:

Claude Desktop (Windows):

Bearbeiten Sie %APPDATA%\Claude\settings.json:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["C:\\path\\to\\yt-dlp-MCP\\index.js"]
    }
  }
}

Claude Desktop (macOS/Linux):

Bearbeiten Sie ~/Library/Application Support/Claude/settings.json (macOS) oder den entsprechenden Konfigurationspfad:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["/path/to/yt-dlp-MCP/index.js"]
    }
  }
}

Wichtig: Stellen Sie sicher, dass yt-dlp.exe (Windows) oder yt-dlp (macOS/Linux) entweder:

• Im selben Verzeichnis wie index.js liegt

• Oder in Ihrem System-PATH verfügbar ist

Schritt 6: Claude Desktop neu starten

Nach dem Hinzufügen der Konfiguration starten Sie Claude Desktop neu, um den neuen MCP-Server zu laden.

Verwendung

Nach der Konfiguration können Sie Claude bitten:

• "Laden Sie dieses YouTube-Video herunter: [URL]"

• "Laden Sie nur das Audio aus diesem Video als MP3 herunter"

• "Informationen zu diesem Video abrufen, ohne es herunterzuladen"

• "Alle verfügbaren Formate für dieses Video auflisten"

• "Suchen Sie auf YouTube nach Videos zu [Thema]"

• "Untertitel für dieses Video auf Spanisch herunterladen"

Verfügbare Tools

download_video

Lädt Videos von URLs herunter.

Parameter:

• url (erforderlich): Video-URL

• outputDir: Ausgabeverzeichnis (Standard: aktuelles Verzeichnis)

• format: Formatauswahl (Standard: "best")

• quality: Videoqualität (z. B. "1080p", "720p")

• audioOnly: Nur Audio herunterladen (Standard: false)

• audioFormat: Audioformat für die Extraktion (Standard: "mp3")

• subtitles: Untertitel herunterladen (Standard: false)

• subtitleLangs: Untertitelsprachen (Standard: "en")

• playlistStart/playlistEnd: Playlist-Bereich

• noPlaylist: Nur einzelnes Video herunterladen (Standard: false)

• additionalArgs: Zusätzliche yt-dlp-Argumente

Beispiele:

Ein YouTube-Video herunterladen:

{
  "url": "https://www.youtube.com/watch?v=...",
  "quality": "1080p",
  "subtitles": true
}

Nur Audio herunterladen:

{
  "url": "https://www.youtube.com/watch?v=...",
  "audioOnly": true,
  "audioFormat": "mp3"
}

download_stream

Lädt Live-Streams oder HLS-Streams herunter.

Parameter:

• url (erforderlich): Stream-URL

• outputDir: Ausgabeverzeichnis

• duration: Aufnahmedauer in Sekunden

• format: Formatpräferenz (Standard: "best")

• outputName: Benutzerdefinierter Ausgabedateiname

• hlsUseMpegts: MPEG-TS für HLS verwenden (Standard: true)

• additionalArgs: Zusätzliche Argumente

get_video_info

Ruft Video-Metadaten ab, ohne herunterzuladen.

Parameter:

• url (erforderlich): Video-URL

• flatPlaylist: Schnellere Playlist-Informationen (Standard: false)

list_formats

Listet alle verfügbaren Formate für eine URL auf.

Parameter:

• url (erforderlich): Video-URL

search_videos

Sucht nach Videos mit yt-dlp-Extraktoren.

Parameter:

• query (erforderlich): Suchanfrage

• extractor: Such-Extraktor-Präfix (Standard: "ytsearch10")

• getInfo: Detaillierte Informationen abrufen (Standard: true)

Beispiel:

{
  "query": "programming tutorials",
  "extractor": "ytsearch5"
}

update_yt_dlp

Aktualisiert yt-dlp auf die neueste Version.

Unterstützte Websites

yt-dlp unterstützt über 1000 Websites, darunter:

• YouTube

• Twitch

• Vimeo

• Twitter/X

• Instagram

• TikTok

• Facebook

• SoundCloud

• Und viele mehr...

Die vollständige Liste finden Sie unter yt-dlp unterstützte Websites.

Fehlerbehebung

yt-dlp nicht gefunden

• Stellen Sie sicher, dass yt-dlp.exe (Windows) oder yt-dlp (macOS/Linux) im selben Verzeichnis wie der Server oder in Ihrem PATH liegt

• Unter Windows müssen Sie das Verzeichnis möglicherweise zu Ihrer PATH-Umgebungsvariable hinzufügen

Node.js-Fehler

• Stellen Sie sicher, dass Node.js 18+ installiert ist: node --version

• Stellen Sie sicher, dass die Abhängigkeiten installiert sind: npm install

Format nicht verfügbar

• Einige Videos haben möglicherweise nicht das angeforderte Format. Verwenden Sie list_formats, um verfügbare Optionen zu sehen

• YouTube kann einige Formate einschränken. Versuchen Sie verschiedene Qualitätseinstellungen

Lizenz

Unlicense

Danksagungen

• yt-dlp - Der leistungsstarke Video-Downloader, der dies möglich macht

• Model Context Protocol - Das Protokoll, das KI-Assistenten die Nutzung von Tools ermöglicht