remotion-mcp-server

Ein MCP-Server (Model Context Protocol), der Claude die Fähigkeit gibt, Referenzvideos zu analysieren und gebrandete Instagram-Reels / YouTube-Shorts zu erstellen – mit Remotion (programmatische Videos auf React-Basis) – vollständig aus einer Chat-Konversation heraus.

Weisen Sie Claude auf ein Referenz-Reel hin, und es kann:

1. Das Video herunterladen (yt-dlp), Frames + Audio extrahieren und ein vollständiges Transkript erhalten (zuerst YouTube-Untertitel, faster-whisper als Fallback für alles andere – Instagram, TikTok, lokale Dateien).

2. Eine neue Komposition im gleichen Stil erstellen – Dialog-Sprechblasen-Reels oder Fakten/Listen-Reels – als echten React/TSX-Code.

3. Die Komposition mit Remotion zu MP4 rendern.

4. Ihnen sagen, wie Sie die Komposition in Remotion Studio öffnen, um sie durchzusehen und zu überprüfen, bevor Sie sie als final betrachten.

Kein CapCut, keine manuelle Bearbeitung – Claude schreibt das Video.

Tools

Beide create_*-Tools geben einen preview-Hinweis zurück, der Claude/Ihnen sagt, wie Sie die Komposition in Remotion Studio öffnen (npm run dev → localhost:3000), bevor Sie das Rendering als final betrachten.

Related MCP server: cutgent

Einrichtung

1. Klonen und Python-Abhängigkeiten installieren

git clone https://github.com/<your-username>/remotion-mcp-server.git
cd remotion-mcp-server
pip install -r requirements.txt

Sie benötigen außerdem ffmpeg in Ihrem PATH (oder installieren Sie imageio-ffmpeg, auf das der Server automatisch zurückfällt).

2. Das Remotion-Projekt einrichten

Dieser Server benötigt ein Remotion-Projekt, in das generierte Kompositionen geschrieben und aus dem gerendert wird. Ein einsatzbereiter Starter ist enthalten:

cd remotion-template
npm install
cd ..

Oder setzen Sie REMOTION_MCP_PROJECT auf Ihr eigenes bestehendes Remotion-Projekt – es benötigt nur die beiden Markierungskommentare aus remotion-template/src/Root.tsx, die in dessen Root.tsx vorhanden sein müssen.

3. Konfigurieren (optional)

Kopieren Sie .env.example nach .env und passen Sie es an, wenn Sie nicht die Standardwerte verwenden (benutzerdefinierte yt-dlp/ffmpeg-Pfade, ein anderer Projektordner, ein Standard-Wasserzeichen).

4. Bei Claude registrieren

Fügen Sie es zur MCP-Konfiguration von Claude Desktop / Claude Code hinzu:

{
  "mcpServers": {
    "remotion-video": {
      "command": "python",
      "args": ["/absolute/path/to/remotion-mcp-server/server.py"]
    }
  }
}

Starten Sie Claude neu und bitten Sie es, ein Referenz-Reel zu analysieren und Ihnen eines im gleichen Stil zu erstellen.

So funktioniert es

• analyze_video lädt mit yt-dlp herunter, extrahiert Frames + Audio mit ffmpeg und transkribiert dann: zuerst YouTube-Untertitel über youtube-transcript-api, mit Fallback auf lokale faster-whisper-Transkription für alles andere.

• create_dialogue_reel / create_facts_reel erstellen eine .tsx-Kompositionsdatei aus einer Vorlage, registrieren sie in der Root.tsx des Remotion-Projekts zwischen Markierungskommentaren und rufen npx remotion render auf.

• Generierte Kompositionen erscheinen live in Remotion Studio (npm run dev) per Hot-Reload – kein Neustart erforderlich – sodass Sie durchsehen und überprüfen können, bevor Sie ein Rendering als final betrachten.

Lizenz

MIT – siehe LICENSE.