Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

Video Understanding MCP

von granitebpsVersion 1.0.2i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.granitebps/video-understanding-mcp

So installierst du es

Was es kann

Let AI agents watch videos and answer questions about them through any OpenAI-compatible endpoint.

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Braucht VIDEO_API_KEY, VIDEO_EXTRA_HEADERS · 2 Einstellungen auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL)
  • Kategorie Design, Bilder & Audio

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

von pbakaus★ 113.5361 Skills

Skill · Anleitung

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

von cathrynlavery★ 68.7131 Skills

Skill · Anleitung

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

von zarazhangrui★ 32.6391 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Video Understanding MCP. Folge https://mcp.popnx.com/i/granitebps-video-understanding-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Video Understanding MCP für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "video-understanding": { "command": "npx", "args": [ "-y", "@granitebps/video-understanding-mcp" ], "env": { "VIDEO_BASE_URL": "your-value", "VIDEO_MODEL": "your-value", "VIDEO_API_KEY": "your-value", "VIDEO_EXTRA_HEADERS": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei VIDEO_API_KEY, VIDEO_EXTRA_HEADERS, VIDEO_BASE_URL, VIDEO_MODEL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Video Understanding MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Video Understanding MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • VIDEO_BASE_URL Basis-URL eines OpenAI-kompatiblen Chat-Completions-Endpunkts, dessen Modell Video unterstützt, z. B. https://host/v1
      Englisches Original anzeigenBase URL of an OpenAI-compatible chat completions endpoint whose model accepts video, e.g. https://host/v1
    • VIDEO_MODEL Modell (oder Router-Alias), an das Videos gesendet werden
      Englisches Original anzeigenModel (or router alias) to send videos to

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Einstellungsdatei der Claude-Desktop-App öffnen

    SettingsDeveloperEdit Config

  5. Diese Einstellungen einfügen und speichern

    {
      "mcpServers": {
        "video-understanding": {
          "command": "npx",
          "args": [
            "-y",
            "@granitebps/video-understanding-mcp"
          ],
          "env": {
            "VIDEO_BASE_URL": "your-value",
            "VIDEO_MODEL": "your-value",
            "VIDEO_API_KEY": "your-value",
            "VIDEO_EXTRA_HEADERS": "your-value"
          }
        }
      }
    }

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. Claude beenden und neu öffnen

  7. Ausprobieren

    Nutze Video Understanding MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Video Understanding MCP nutzt, oder ein Werkzeug von Video Understanding MCP in der Antwort zeigt, bist du verbunden

5 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • VIDEO_PART_FORMAT Wie das Video angehängt wird: video_url, image_url, file oder input_file
    Englisches Original anzeigenHow the video is attached: video_url, image_url, file, or input_file
    · Standard image_url
  • VIDEO_MAX_DURATION_SECONDS Längster analysierter Bereich in Sekunden
    Englisches Original anzeigenLongest analyzed range in seconds
    · Standard 300
  • VIDEO_MAX_UPLOAD_MB Größtes an den Endpunkt gesendetes vorbereitetes Video in MB.
    Englisches Original anzeigenLargest prepared video sent to the endpoint, in MB
    · Standard 15
  • VIDEO_ALLOWED_DIRS Verzeichnisse, aus denen lokale Dateien gelesen werden dürfen; lokale Dateien werden abgelehnt, wenn nicht gesetzt.
    Englisches Original anzeigenDirectories local files may be read from; local files are refused when unset
  • VIDEO_VERIFY_MEDIA Lässt Aufrufe fehlschlagen, wenn der Endpunkt das Video offensichtlich ignoriert hat
    Englisches Original anzeigenFail calls when the endpoint evidently ignored the video
    · Standard true

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Video Understanding MCP noch nicht verbinden

Video Understanding MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Video Understanding MCP verbinden kann

  • Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
  • Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
  • Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

B · Andere in Design, Bilder & Audio, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Video Understanding MCP für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user video-understanding --env VIDEO_BASE_URL=your-value --env VIDEO_MODEL=your-value --env VIDEO_API_KEY=your-value --env VIDEO_EXTRA_HEADERS=your-value -- npx -y @granitebps/video-understanding-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei VIDEO_API_KEY, VIDEO_EXTRA_HEADERS, VIDEO_BASE_URL, VIDEO_MODEL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Video Understanding MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Video Understanding MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • VIDEO_BASE_URL Basis-URL eines OpenAI-kompatiblen Chat-Completions-Endpunkts, dessen Modell Video unterstützt, z. B. https://host/v1
      Englisches Original anzeigenBase URL of an OpenAI-compatible chat completions endpoint whose model accepts video, e.g. https://host/v1
    • VIDEO_MODEL Modell (oder Router-Alias), an das Videos gesendet werden
      Englisches Original anzeigenModel (or router alias) to send videos to

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  5. Diesen Befehl einfügen und Enter drücken

    claude mcp add --scope user video-understanding --env VIDEO_BASE_URL=your-value --env VIDEO_MODEL=your-value --env VIDEO_API_KEY=your-value --env VIDEO_EXTRA_HEADERS=your-value -- npx -y @granitebps/video-understanding-mcp

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. /mcp in Claude Code eingeben

    Video Understanding MCP sollte in der Liste als verbunden erscheinen

  7. Ausprobieren

    Nutze Video Understanding MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Video Understanding MCP nutzt, oder ein Werkzeug von Video Understanding MCP in der Antwort zeigt, bist du verbunden

5 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • VIDEO_PART_FORMAT Wie das Video angehängt wird: video_url, image_url, file oder input_file
    Englisches Original anzeigenHow the video is attached: video_url, image_url, file, or input_file
    · Standard image_url
  • VIDEO_MAX_DURATION_SECONDS Längster analysierter Bereich in Sekunden
    Englisches Original anzeigenLongest analyzed range in seconds
    · Standard 300
  • VIDEO_MAX_UPLOAD_MB Größtes an den Endpunkt gesendetes vorbereitetes Video in MB.
    Englisches Original anzeigenLargest prepared video sent to the endpoint, in MB
    · Standard 15
  • VIDEO_ALLOWED_DIRS Verzeichnisse, aus denen lokale Dateien gelesen werden dürfen; lokale Dateien werden abgelehnt, wenn nicht gesetzt.
    Englisches Original anzeigenDirectories local files may be read from; local files are refused when unset
  • VIDEO_VERIFY_MEDIA Lässt Aufrufe fehlschlagen, wenn der Endpunkt das Video offensichtlich ignoriert hat
    Englisches Original anzeigenFail calls when the endpoint evidently ignored the video
    · Standard true

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Video Understanding MCP für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "video-understanding": { "command": "npx", "args": [ "-y", "@granitebps/video-understanding-mcp" ], "env": { "VIDEO_BASE_URL": "your-value", "VIDEO_MODEL": "your-value", "VIDEO_API_KEY": "your-value", "VIDEO_EXTRA_HEADERS": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei VIDEO_API_KEY, VIDEO_EXTRA_HEADERS, VIDEO_BASE_URL, VIDEO_MODEL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Video Understanding MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Video Understanding MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • VIDEO_BASE_URL Basis-URL eines OpenAI-kompatiblen Chat-Completions-Endpunkts, dessen Modell Video unterstützt, z. B. https://host/v1
      Englisches Original anzeigenBase URL of an OpenAI-compatible chat completions endpoint whose model accepts video, e.g. https://host/v1
    • VIDEO_MODEL Modell (oder Router-Alias), an das Videos gesendet werden
      Englisches Original anzeigenModel (or router alias) to send videos to

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Video Understanding MCP ist VIDEO_API_KEY, VIDEO_EXTRA_HEADERS, VIDEO_BASE_URL, VIDEO_MODEL leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in Cursor im Agent-Modus öffnen

  7. Ausprobieren

    Nutze Video Understanding MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Video Understanding MCP nutzt, oder ein Werkzeug von Video Understanding MCP in der Antwort zeigt, bist du verbunden

5 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • VIDEO_PART_FORMAT Wie das Video angehängt wird: video_url, image_url, file oder input_file
    Englisches Original anzeigenHow the video is attached: video_url, image_url, file, or input_file
    · Standard image_url
  • VIDEO_MAX_DURATION_SECONDS Längster analysierter Bereich in Sekunden
    Englisches Original anzeigenLongest analyzed range in seconds
    · Standard 300
  • VIDEO_MAX_UPLOAD_MB Größtes an den Endpunkt gesendetes vorbereitetes Video in MB.
    Englisches Original anzeigenLargest prepared video sent to the endpoint, in MB
    · Standard 15
  • VIDEO_ALLOWED_DIRS Verzeichnisse, aus denen lokale Dateien gelesen werden dürfen; lokale Dateien werden abgelehnt, wenn nicht gesetzt.
    Englisches Original anzeigenDirectories local files may be read from; local files are refused when unset
  • VIDEO_VERIFY_MEDIA Lässt Aufrufe fehlschlagen, wenn der Endpunkt das Video offensichtlich ignoriert hat
    Englisches Original anzeigenFail calls when the endpoint evidently ignored the video
    · Standard true

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code, aber erst etwas vorbereiten

Du brauchst einen Schlüssel von Video Understanding MCP (auf der Seite des Anbieters erstellen) · 2 Einstellung(en) auszufüllen (VIDEO_BASE_URL, VIDEO_MODEL) · Installiere zuerst Node.js auf deinem Computer (nur einmal)

Von der KI installieren lassen

Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.

Installiere bitte den MCP server Video Understanding MCP für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "video-understanding": { "type": "stdio", "command": "npx", "args": [ "-y", "@granitebps/video-understanding-mcp" ], "env": { "VIDEO_BASE_URL": "your-value", "VIDEO_MODEL": "your-value", "VIDEO_API_KEY": "your-value", "VIDEO_EXTRA_HEADERS": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei VIDEO_API_KEY, VIDEO_EXTRA_HEADERS, VIDEO_BASE_URL, VIDEO_MODEL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Video Understanding MCP wirklich erscheinen.

Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.

  1. Node.js installieren (falls noch nicht vorhanden)

    Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter

    node -v
    • Eine Versionsnummer wie v26.13.1 = installiert, diesen Schritt überspringen
    • "command not found" (unter Windows "is not recognized") = noch nicht installiert, oder gerade installiert und das Terminal muss neu geöffnet werden
    So öffnest du das Terminal

    Mac: ⌘ + Leertaste drücken, Terminal eingeben, Enter

    Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen

    Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig

    Download-Seite von Node.js öffnen ↗

    Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v

    Einmal installieren, gilt für alles, was Node.js braucht

  2. Bei Video Understanding MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  3. 2 Einstellung(en) ausfüllen

    Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.

    • VIDEO_BASE_URL Basis-URL eines OpenAI-kompatiblen Chat-Completions-Endpunkts, dessen Modell Video unterstützt, z. B. https://host/v1
      Englisches Original anzeigenBase URL of an OpenAI-compatible chat completions endpoint whose model accepts video, e.g. https://host/v1
    • VIDEO_MODEL Modell (oder Router-Alias), an das Videos gesendet werden
      Englisches Original anzeigenModel (or router alias) to send videos to

    Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

  4. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  5. Schlüssel eintragen

    In den Einstellungen von Video Understanding MCP ist VIDEO_API_KEY, VIDEO_EXTRA_HEADERS, VIDEO_BASE_URL, VIDEO_MODEL leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  6. KI-Chat in VS Code im Agent-Modus öffnen

  7. Ausprobieren

    Nutze Video Understanding MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Video Understanding MCP nutzt, oder ein Werkzeug von Video Understanding MCP in der Antwort zeigt, bist du verbunden

5 optionale Einstellung(en) (geht auch ohne)

Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.

  • VIDEO_PART_FORMAT Wie das Video angehängt wird: video_url, image_url, file oder input_file
    Englisches Original anzeigenHow the video is attached: video_url, image_url, file, or input_file
    · Standard image_url
  • VIDEO_MAX_DURATION_SECONDS Längster analysierter Bereich in Sekunden
    Englisches Original anzeigenLongest analyzed range in seconds
    · Standard 300
  • VIDEO_MAX_UPLOAD_MB Größtes an den Endpunkt gesendetes vorbereitetes Video in MB.
    Englisches Original anzeigenLargest prepared video sent to the endpoint, in MB
    · Standard 15
  • VIDEO_ALLOWED_DIRS Verzeichnisse, aus denen lokale Dateien gelesen werden dürfen; lokale Dateien werden abgelehnt, wenn nicht gesetzt.
    Englisches Original anzeigenDirectories local files may be read from; local files are refused when unset
  • VIDEO_VERIFY_MEDIA Lässt Aufrufe fehlschlagen, wenn der Endpunkt das Video offensichtlich ignoriert hat
    Englisches Original anzeigenFail calls when the endpoint evidently ignored the video
    · Standard true

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Video Understanding MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user video-understanding --env VIDEO_BASE_URL=your-value --env VIDEO_MODEL=your-value --env VIDEO_API_KEY=your-value --env VIDEO_EXTRA_HEADERS=your-value -- npx -y @granitebps/video-understanding-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "video-understanding": {
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/video-understanding-mcp"
      ],
      "env": {
        "VIDEO_BASE_URL": "your-value",
        "VIDEO_MODEL": "your-value",
        "VIDEO_API_KEY": "your-value",
        "VIDEO_EXTRA_HEADERS": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "video-understanding": {
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/video-understanding-mcp"
      ],
      "env": {
        "VIDEO_BASE_URL": "your-value",
        "VIDEO_MODEL": "your-value",
        "VIDEO_API_KEY": "your-value",
        "VIDEO_EXTRA_HEADERS": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "video-understanding": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@granitebps/video-understanding-mcp"
      ],
      "env": {
        "VIDEO_BASE_URL": "your-value",
        "VIDEO_MODEL": "your-value",
        "VIDEO_API_KEY": "your-value",
        "VIDEO_EXTRA_HEADERS": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • VIDEO_BASE_URL erforderlich env
    Basis-URL eines OpenAI-kompatiblen Chat-Completions-Endpunkts, dessen Modell Video unterstützt, z. B. https://host/v1
    Englisches Original anzeigenBase URL of an OpenAI-compatible chat completions endpoint whose model accepts video, e.g. https://host/v1
  • VIDEO_MODEL erforderlich env
    Modell (oder Router-Alias), an das Videos gesendet werden
    Englisches Original anzeigenModel (or router alias) to send videos to
  • VIDEO_API_KEY geheim erforderlich env
    API-Schlüssel des Endpunkts, der als Bearer-Token gesendet wird
    Englisches Original anzeigenEndpoint API key, sent as a bearer token
  • VIDEO_EXTRA_HEADERS geheim erforderlich env
    Zusätzliche Endpunkt-Anfrage-Header als JSON-Objekt, etwa Cloudflare-Access-Service-Token-Header.
    Englisches Original anzeigenExtra endpoint request headers as a JSON object, such as Cloudflare Access service-token headers
  • VIDEO_PART_FORMAT env
    Wie das Video angehängt wird: video_url, image_url, file oder input_file
    Englisches Original anzeigenHow the video is attached: video_url, image_url, file, or input_file
  • VIDEO_MAX_DURATION_SECONDS env
    Längster analysierter Bereich in Sekunden
    Englisches Original anzeigenLongest analyzed range in seconds
  • VIDEO_MAX_UPLOAD_MB env
    Größtes an den Endpunkt gesendetes vorbereitetes Video in MB.
    Englisches Original anzeigenLargest prepared video sent to the endpoint, in MB
  • VIDEO_ALLOWED_DIRS env
    Verzeichnisse, aus denen lokale Dateien gelesen werden dürfen; lokale Dateien werden abgelehnt, wenn nicht gesetzt.
    Englisches Original anzeigenDirectories local files may be read from; local files are refused when unset
  • VIDEO_VERIFY_MEDIA env
    Lässt Aufrufe fehlschlagen, wenn der Endpunkt das Video offensichtlich ignoriert hat
    Englisches Original anzeigenFail calls when the endpoint evidently ignored the video

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft auf deinem Computer
Neueste Versioni
1.0.2
In der Registry veröffentlichti
13. Nov. 2026
Code zuletzt geänderti
16. Nov. 2026
Entwickler
granitebps
Pakete
npm: @granitebps/video-understanding-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto granitebps bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 4 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für @granitebps/video-understanding-mcp@1.0.2

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 16. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/granitebps-video-understanding-mcp.svg)](https://mcp.popnx.com/en/servers/granitebps-video-understanding-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Design, Bilder & Audioi

  • Mehr Sterne als 0 % der anderen 3358 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 81 % der anderen 3358 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3358 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Video Understanding MCP sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: VIDEO_API_KEY, VIDEO_EXTRA_HEADERS

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 4 Tagen geändert, und die neueste Version (1.0.2) kam vor 7 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

von heygen-comWeit verbreitet★ 87.226 Sterne des ganzen ReposAktualisiert vorgestern

Läuft in der Cloud✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

von pascalorgWeit verbreitet↓ 1037/Wo.★ 25.650 Sterne des ganzen ReposAktualisiert vorgestern

Computer oder Cloud✓ vom Dienst · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

von jgraphWeit verbreitet★ 5860Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ vom Dienst · draw.ioVom PopNx-Team ausprobiert

Figma MCP Server

The Figma MCP server brings Figma design context directly into your AI workflow.

von figmaWeit verbreitet★ 2213Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · mcp.figma.com

Remocn: Remotion MCP server

Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.

von RemocnWachsend★ 1812Aktualisiert vor 10 Tagen

Läuft in der Cloud✓ vom Dienst · remocn.dev
Im Vergleich mit ähnlichen
Dieser
Video Understanding MCP
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaNeinNeinJaNein
Basisprüfungen3/34/45/54/44/44/4
LizenzMITApache-2.0MITApache-2.0–MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Video Understanding MCP

An MCP server that lets AI agents watch a video and answer questions about it: what is shown, what is said, what text appears on screen, and when. It works with any OpenAI-compatible chat completions endpoint whose model accepts video, such as Gemini models served through a gateway.

Give it a TikTok, YouTube, or X post URL, a direct media URL from a scraper, or a local file, plus a question. It downloads and shrinks the video, sends it to your endpoint, and returns a structured answer:

{

"answer": "The coach demonstrates three squat variations and warns against letting the knees cave in.", "summary": "A short workout tutorial showing bodyweight squats with form cues.", "speech": { "present": true, "language": "en", "transcript": "Keep your chest up and push through your heels..." }, "on_screen_text": ["3 x 12 reps", "Rest 60s"], "timeline": [{ "start": 12.0, "description": "Switches to jump squats" }], "analysis": { "configuredModel": "your-model", "reportedModel": "gemini-...", "usage": { "promptTokens": 5400, "completionTokens": 480 }, "sourceDurationSeconds": 58.4, "analyzedRange": { "start": 0, "end": 58.4 }, "partFormat": "image_url", "warnings": [] } }

Requirements

  • Node.js 22.21.0 or newer.
  • ffmpeg with ffprobe (required). macOS: brew install ffmpeg. Debian/Ubuntu: sudo apt-get install ffmpeg. Windows: winget install ffmpeg.
  • yt-dlp (optional, needed only for page URLs such as TikTok or YouTube links). macOS: brew install yt-dlp. Others: pipx install yt-dlp.
  • An OpenAI-compatible endpoint and a model that accepts video input.

Check what the server found with the get_server_info tool.

Setup

Add the server to your MCP client. For example, in a JSON-configured client:

{

"mcpServers": { "video-understanding": { "command": "npx", "args": ["-y", "@granitebps/video-understanding-mcp"], "env": { "VIDEO_BASE_URL": "https://your-endpoint.example/v1", "VIDEO_MODEL": "your-video-capable-model", "VIDEO_API_KEY": "your-endpoint-api-key" } } } }

The server also reads a .env file from its working directory. See .env.example.

Tools

understand_video
InputDescription
sourceRequired. A page URL (resolved with yt-dlp), a direct media URL, or an absolute local path inside an allowed directory.
headersOptional request headers for a direct media URL, such as Referer or Cookie returned by a scraper. Sent only to that URL's host.
questionOptional. What to find out. Without it you get a general description.
start_seconds, end_secondsOptional range of the source video to analyze. Needed for videos longer than the duration limit; a short range also gives more detail for fast motion such as workouts.
fpsOptional frame-sampling hint, applied only by request formats that support it.

The result fields are shown above. timeline times are seconds from the start of the source video, even when a range was analyzed. analysis.warnings explains anything the server adjusted or could not confirm.

get_server_info

Shows the version, endpoint host and model, request format, limits, local-file policy, and whether ffmpeg, ffprobe, and yt-dlp are available. It never shows the API key.

Request formats

OpenAI-compatible endpoints disagree on how a video is attached to a chat request, and some silently ignore a format they do not understand. Pick the format your endpoint documents with VIDEO_PART_FORMAT:

VIDEO_PART_FORMATRequest partKnown to be used by
video_url{"type":"video_url","video_url":{"url":"data:video/mp4;base64,..."}}OpenRouter, Alibaba Model Studio (Qwen), Tencent TokenHub, vLLM
image_url (default){"type":"image_url","image_url":{"url":"data:video/mp4;base64,..."}}OpenRouter; routers that translate image parts by the data URL's MIME type, for example 9router's Gemini path
file{"type":"file","file":{"file_data":"data:video/mp4;base64,...","format":"video/mp4"}}LiteLLM (Gemini, vLLM)
input_file{"type":"input_file","file_data":"data:video/mp4;base64,...","mime_type":"video/mp4"}Requesty

fps is sent only with video_url and file.

If the endpoint ignores the video, the call fails with MEDIA_NOT_PROCESSED instead of returning an answer the model made up. The server detects this by sending the same prompt without the video in parallel (16 output tokens at most) and comparing prompt-token usage, which cancels out any fixed overhead the endpoint adds. This doubles the request count. Turn it off with VIDEO_VERIFY_MEDIA=false only for endpoints that report token usage unusually.

Configuration

VariableDefaultDescription
VIDEO_BASE_URL—Required. Endpoint base URL, for example https://host/v1.
VIDEO_MODEL—Required. Model name or router alias.
VIDEO_API_KEY—Sent as Authorization: Bearer .
VIDEO_EXTRA_HEADERS—Extra endpoint request headers as a JSON object, for example Cloudflare Access service-token headers.
VIDEO_PART_FORMATimage_urlimage_url, video_url, file, or input_file.
VIDEO_MAX_DURATION_SECONDS300Longest analyzed range (1–7200).
VIDEO_MAX_UPLOAD_MB15Largest prepared video sent inline, before base64 (1–100).
VIDEO_MAX_DOWNLOAD_MB500Largest source download (1–10000).
VIDEO_REQUEST_TIMEOUT_MS180000Endpoint request timeout (5000–900000).
VIDEO_MAX_CONCURRENCY2Analyses running at once; further calls wait (1–16).
VIDEO_MAX_OUTPUT_TOKENS8192max_tokens for the answer (256–65536).
VIDEO_VERIFY_MEDIAtrueFail calls when the endpoint evidently ignored the video.
VIDEO_ALLOWED_DIRS—Directories local files may be read from, separated by : (; on Windows). Local files are refused when unset.
VIDEO_ALLOW_PRIVATE_NETWORKfalseAllow downloads from loopback and private addresses.
VIDEO_FFMPEG_PATHffmpegffmpeg executable.
VIDEO_FFPROBE_PATHffprobeffprobe executable.
VIDEO_YTDLP_PATHyt-dlpyt-dlp executable.

Invalid values stop the server at startup with a message naming the variable. When VIDEO_BASE_URL or VIDEO_MODEL is missing the server still starts, and understand_video returns CONFIG_MISSING.

How a call works

  1. Checks the configuration, that ffmpeg is installed, and that the base URL answers. If it does not, the call fails with ENDPOINT_UNREACHABLE before anything is downloaded.
  2. Gets the video: reads an allowed local file, downloads a direct media URL, or resolves a page URL with yt-dlp (refusing over-long videos before downloading).
  3. Cuts the requested range and re-encodes it to H.264 with mono AAC audio, with the shorter side at most 480 pixels (480×854 for a portrait clip), dropping to 360 if needed to fit the upload limit.
  4. Sends it inline as base64 with the question, plus the text-only baseline request.
  5. Validates the reply, drops timeline moments outside the analyzed range, and converts times to source-video seconds.

Temporary files are deleted after every call, including failed and cancelled ones.

Errors

Errors start with a code in brackets, for example [LIMIT_EXCEEDED] The analyzed range is 1500 s, over the 300 s limit ..., and carry the same code in _meta["video-understanding-mcp/error"].

CodeMeaning
INVALID_INPUTBad range or source string.
CONFIG_MISSINGVIDEO_BASE_URL or VIDEO_MODEL is not set.
DEPENDENCY_MISSINGffmpeg/ffprobe, or yt-dlp for a page URL, is not installed.
SOURCE_UNAVAILABLEThe page or media URL could not be fetched or extracted (expired link, unsupported site).
SOURCE_NOT_ALLOWEDLocal file outside the allowed directories, or a download target on a private network.
INVALID_MEDIAThe source has no video stream.
LIMIT_EXCEEDEDOver the duration, upload, or download limit, or rejected as too large by the endpoint.
ENDPOINT_UNREACHABLEThe configured base URL is not reachable.
ENDPOINT_AUTHThe endpoint rejected the API key.

| `ENDPOINT_RATE

Nur der Anfang wird gezeigt; den Rest findest du im Repo