Video Editor MCP-Server

Sehen Sie sich hier eine Demo an: https://www.youtube.com/watch?v=KG6TMLD8GmA

Laden Sie Videos aus jedermanns beliebtem LLM und Video Jungle hoch, bearbeiten, suchen und generieren Sie sie.

Um dieses Tool verwenden zu können, müssen Sie sich bei Video Jungle für ein Konto anmelden und Ihren API-Schlüssel hinzufügen.

Komponenten

Ressourcen

Der Server implementiert eine Schnittstelle zum Hochladen, Generieren und Bearbeiten von Videos mit:

• Benutzerdefiniertes vj://-URI-Schema für den Zugriff auf einzelne Videos und Projekte

• Jede Projektressource hat einen Namen, eine Beschreibung

• Suchergebnisse werden mit Metadaten darüber zurückgegeben, was im Video zu sehen ist und wann, sodass eine Bearbeitung direkt erfolgen kann.

Eingabeaufforderungen

Demnächst verfügbar.

Werkzeuge

Der Server implementiert einige Tools:

• Video hinzufügen

  • Fügt eine Videodatei zur Analyse über eine URL hinzu. Gibt eine vj://-URI zurück, um auf die Videodatei zu verweisen.

• Videojungle-Projekt erstellen

  • Erstellt ein Video Jungle-Projekt, das generative Skripte, analysierte Videos und Bilder für die Videobearbeitung enthält

• lokal bearbeiten

  • Erstellt ein OpenTimelineIO-Projekt und lädt es auf Ihren Computer herunter, um es in einer Davinci Resolve Studio-Instanz zu öffnen (Resolve Studio muss bereits ausgeführt werden, bevor dieses Tool aufgerufen wird).

• Generieren/Bearbeiten von Videos

  • Generiert einen gerenderten Videoschnitt aus einer Reihe von Videodateien

• Bearbeiten aus einem einzelnen Video generieren

  • Erstellen Sie eine Bearbeitung aus einer einzelnen Eingabevideodatei

• Projekt-Assets abrufen

  • Holen Sie sich Assets innerhalb eines Projekts zur Generierung von Videobearbeitungen.

• Suchvideos

  • Gibt Videoübereinstimmungen basierend auf Einbettungen und Schlüsselwörtern zurück

• Update-Video-Bearbeitung

  • Aktualisieren Sie die Informationen einer Videobearbeitung live. Wenn Video Jungle geöffnet ist, wird die Bearbeitung in Echtzeit aktualisiert.

Tools in der Praxis anwenden

Um die Tools zu verwenden, müssen Sie sich bei Video Jungle anmelden und Ihren API-Schlüssel hinzufügen.

Video hinzufügen

Hier ist eine Beispielaufforderung zum Aufrufen des Tools add-video :

can you download the video at https://www.youtube.com/shorts/RumgYaH5XYw and name it fly traps?

Dadurch wird ein Video von einer URL heruntergeladen, Ihrer Bibliothek hinzugefügt und für den späteren Abruf analysiert. Die Analyse ist multimodal, sodass sowohl Audio- als auch visuelle Komponenten abgefragt werden können.

Suchvideos

Sobald Sie ein Video heruntergeladen und analysiert haben, können Sie mit dem Tool search-videos Abfragen dazu durchführen:

can you search my videos for fly traps?

Die Suchergebnisse enthalten relevante Metadaten zum Erstellen einer Videobearbeitung entsprechend den bei der ersten Analyse ermittelten Details.

Suche nach lokalen Videos

Sie müssen die Umgebungsvariable LOAD_PHOTOS_DB=1 festlegen, um dieses Tool zu verwenden, da Claude dann aufgefordert wird, auf Ihre Dateien auf Ihrem lokalen Computer zuzugreifen.

Sobald dies erledigt ist, können Sie mithilfe der Tags von Apple in Ihrer Fotos-App nach auf Ihrem Telefon vorhandenen Videos suchen.

Wenn ich in meinem Fall nach „Skateboard“ suche, erhalte ich 1903 Videodateien.

can you search my local video files for Skateboard?

Generieren/Bearbeiten von Videos

Schließlich können Sie diese Suchergebnisse verwenden, um eine Bearbeitung zu generieren:

can you create an edit of all the times the video says "fly trap"?

(Derzeit) basiert das Videobearbeitungstool auf dem Kontext innerhalb des aktuellen Chats.

Bearbeiten aus einem einzelnen Video generieren

Schließlich können Sie eine Bearbeitung aus einem einzelnen, vorhandenen Video herausschneiden:

can you create an edit of all the times this video says the word "fly trap"?

Related MCP server: Sora 2 MCP Server

Konfiguration

Melden Sie sich bei den Video Jungle-Einstellungen an und holen Sie sich Ihren API-Schlüssel . Starten Sie anschließend Video Jungle MCP mit diesem:

$ uv run video-editor-mcp YOURAPIKEY

So erlauben Sie diesem MCP-Server, Ihre Fotos-App unter MacOS zu durchsuchen:

$ LOAD_PHOTOS_DB=1 uv run video-editor-mcp YOURAPIKEY

Schnellstart

Installieren

Installation über Smithery

So installieren Sie Video Editor für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install video-editor-mcp --client claude

Claude Desktop

Sie müssen Ihre claude_desktop_config.json manuell anpassen:

Unter MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Unter Windows: %APPDATA%/Claude/claude_desktop_config.json

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uvx",
     "args": [
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

 "mcpServers": {
   "video-editor-mcp": {
     "command": "uv",
     "args": [
       "--directory",
       "/Users/YOURDIRECTORY/video-editor-mcp",
       "run",
       "video-editor-mcp",
       "YOURAPIKEY"
     ]
   }
 }

Bei aktiviertem lokalem Zugriff auf die Fotos-App (suchen Sie in Ihrer Fotos-App):

  "video-jungle-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/<PATH_TO>/video-jungle-mcp",
      "run",
      "video-editor-mcp",
      "<YOURAPIKEY>"
    ],
   "env": {
        "LOAD_PHOTOS_DB": "1"
    }
  },

Denken Sie daran, die Verzeichnisse durch die Verzeichnisse zu ersetzen, in denen Sie das Repository auf Ihrem Computer abgelegt haben.

Entwicklung

Erstellen und Veröffentlichen

So bereiten Sie das Paket für die Verteilung vor:

1. Abhängigkeiten synchronisieren und Sperrdatei aktualisieren:

uv sync

2. Erstellen Sie Paketverteilungen:

uv build

Dadurch werden Quell- und Wheel-Distributionen im Verzeichnis dist/ erstellt.

3. Auf PyPI veröffentlichen:

uv publish

Hinweis: Sie müssen PyPI-Anmeldeinformationen über Umgebungsvariablen oder Befehlsflags festlegen:

• Token: --token oder UV_PUBLISH_TOKEN

• Oder Benutzername/Passwort: --username / UV_PUBLISH_USERNAME und --password / UV_PUBLISH_PASSWORD

Debuggen

Da MCP-Server über stdio laufen, kann das Debuggen eine Herausforderung darstellen. Für ein optimales Debugging empfehlen wir dringend die Verwendung des MCP Inspector .

Sie können den MCP Inspector über npm mit diesem Befehl starten:

(Ersetzen Sie YOURDIRECTORY und YOURAPIKEY durch das Verzeichnis, in dem sich dieses Repo befindet, und Ihren Video Jungle-API-Schlüssel, den Sie auf der Einstellungsseite finden.)

npx @modelcontextprotocol/inspector uv run --directory /Users/YOURDIRECTORY/video-editor-mcp video-editor-mcp YOURAPIKEY

Beim Start zeigt der Inspector eine URL an, auf die Sie in Ihrem Browser zugreifen können, um mit dem Debuggen zu beginnen.

Zusätzlich habe ich die Protokollierung in app.log im Projektverzeichnis hinzugefügt. Sie können die Protokollierung zur Diagnose von API-Aufrufen wie folgt hinzufügen:

logging.info("this is a test log")

Eine sinnvolle Möglichkeit, Ihre Arbeit am Projekt zu verfolgen, besteht darin, eine Terminalsitzung zu öffnen und Folgendes auszuführen:

$ tail -n 90 -f app.log