video-watcher MCP server

Ein MCP-Server, der es Claude Desktop ermöglicht, Videos von YouTube, Instagram, Facebook oder einer direkten Video-URL (mp4/webm usw.) zu „schauen“ und Fragen dazu zu beantworten.

Was er tut

Für jede unterstützte URL führt der Server Folgendes aus:

1. Lädt das Video mit yt-dlp herunter (funktioniert für YouTube, Instagram, Facebook und Hunderte anderer Websites; für einfache Datei-URLs wird auf einen reinen HTTP-Download zurückgegriffen).

2. Extrahiert ein Transkript – YouTube-Untertitel über youtube-transcript-api, falls verfügbar, andernfalls Audiotranskription über faster-whisper.

3. Extrahiert 5 Schlüsselbilder (über die Zeitleiste des Videos verteilt) als Base64-JPEGs mit OpenCV.

Die Ergebnisse werden pro URL für die Lebensdauer des Prozesses im Speicher zwischengespeichert. Wenn also mehrere Tools für dasselbe Video aufgerufen werden, wird es nur einmal heruntergeladen/transkribiert.

Related MCP server: Video MCP

Werkzeuge

• watch_video(url) – vollständige Analyse: Titel, Dauer, Transkript, Bilder.

• summarize_video(url) – Zusammenfassung (~200 Wörter) + Aufzählung der wichtigsten Punkte.

• answer_about_video(url, question) – Transkript + Bilder, damit Claude eine bestimmte Frage zum Video beantworten kann.

Einrichtung

cd D:\Projects\video-mcp-server
pip install -r requirements.txt

Außerdem benötigen Sie ffmpeg in Ihrem PATH (erforderlich für yt-dlp zum Muxen und für faster-whisper zur Audiodekodierung). Unter Windows installieren Sie es mit winget install ffmpeg oder laden es von https://ffmpeg.org herunter und fügen es zum PATH hinzu.

Testen Sie den Server zuerst eigenständig:

python video_mcp_server.py

Er sollte auf stdio warten (keine Ausgabe = gut; er protokolliert auf stderr).

Mit Claude Desktop verbinden

Bearbeiten Sie %APPDATA%\Claude\claude_desktop_config.json (erstellen Sie die Datei, falls sie nicht existiert) und fügen Sie Folgendes ein:

{
  "mcpServers": {
    "video-watcher": {
      "command": "python",
      "args": ["D:\\Projects\\video-mcp-server\\video_mcp_server.py"]
    }
  }
}

Passen Sie den Pfad an, falls Sie das Repository woanders geklont haben. Wenn python in der Umgebung von Claude Desktop nicht im PATH ist, verwenden Sie stattdessen den vollständigen Interpreterpfad, z. B. "C:\\Users\\<Benutzer>\\AppData\\Local\\Programs\\Python\\Python311\\python.exe".

Beenden Sie Claude Desktop nach der Bearbeitung der Konfiguration vollständig und öffnen Sie es erneut (das Schließen des Fensters reicht unter Windows ebenfalls nicht – verwenden Sie das Symbol in der Taskleiste, um zu beenden).

Testen

Probieren Sie Folgendes aus, sobald die Verbindung steht:

• watch_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

• summarize_video("https://www.youtube.com/shorts/<some-short-id>")

• answer_about_video("https://www.instagram.com/reel/<reel-id>/", "Welches Produkt wird beworben?")

Fragen Sie Claude direkt, z. B.: „Schau dir dieses Video an und fasse es zusammen: "

Hinweise und Einschränkungen

• Instagram: Öffentliche Beiträge/Reels funktionieren über yt-dlp. Private Konten oder Beiträge, die eine Anmeldung erfordern, schlagen mit einer klaren Fehlermeldung fehl – dieser Server speichert keine Instagram-Anmeldedaten und verwendet auch keine. instagrapi ist als optionale Abhängigkeit für zukünftige Erweiterungen aufgeführt, wird aber vom aktuellen Codepfad nicht benötigt.

• Facebook: Nur öffentliche Videos; die gleiche Anmeldebeschränkung gilt.

• Whisper-Fallback: Beim ersten Aufruf, der eine Transkription benötigt, wird das base-Whisper-Modell (~150 MB) heruntergeladen.

• Ratenbegrenzung: Plattformen können wiederholte Anfragen drosseln; der Server meldet einen klaren Fehler „Ratenlimit erreicht, bitte später erneut versuchen", anstatt zu hängen.

• Speicher: Heruntergeladene Videos werden in einem temporären Cache-Verzeichnis (%TEMP%\video_mcp_cache) gespeichert und nicht automatisch bereinigt – leeren Sie es regelmäßig, wenn Speicherplatz eine Rolle spielt.