Remotion Video Production MCP Server

Ein erstklassiger Model Context Protocol (MCP)-Server, der als intelligente Brücke für KI-Agenten dient, um Audio-Beats zu analysieren, Stimmen mit Google Gemini TTS zu synthetisieren und professionelle Videos programmatisch mit Remotion (v4.0+) und React zu erstellen und zu rendern.

Unterstützt BEIDES:

• 💻 Lokaler STDIO-Transport: Für lokale KI-Clients (Antigravity, Claude Desktop, Cursor).

• 🌐 Remote-Streamable-HTTP-Transport: Für Cloud-Bereitstellungen (Render) und webbasierte KI-Clients (Claude Web unter https://claude.ai/new).

🚀 Hauptfunktionen

• 🎬 Programmatisches Scaffolding: Erstellen Sie React/Remotion-Videoprojekte ohne Konfiguration mit integrierten Seitenverhältnissen: TikTok/Reels (tiktok-916), YouTube (youtube-169) und Social (social-11).

• 🎙️ Gemini 3.1 Flash TTS-Integration: Generieren Sie hochwertige Sprachszenen-Dialoge mit regionalen Akzenten und erstellen Sie Wort-für-Wort-Zeitcodes für kinetische Untertitel.

• 🎵 Librosa-Audio-Beat-Synchronisation: Analysieren Sie Hintergrundmusik, um BPM, Beat-Grenzen, RMS-Energieabfälle/-anstiege zu extrahieren und frame-genaue Szenenschnitte zu empfehlen.

• 📸 Visuelle Vorschau-Snapshots: Rendern Sie sofort Frame-Snapshots (PNG/JPEG/WebP) bei jedem Frame-Index zur visuellen KI-Überprüfung.

• ⚡ Headless-Rendering: Kompilieren Sie programmatisch hochwertige MP4/WebM-Videos mit Multi-Core-Parallelitätssteuerung und Fortschrittsverfolgung.

• 🔒 Bearer-Token-Authentifizierung: Sichern Sie Ihre HTTP-MCP-Endpunkte bei der Bereitstellung in öffentlichen Cloud-Diensten.

Related MCP server: atsurae

🛠️ Voraussetzungen

Zum Ausführen dieses MCP-Servers und zum Rendern von Videos benötigt die Host-Umgebung:

1. Node.js (v20.0.0 oder höher empfohlen) und npm.

2. Python 3 (v3.10+ empfohlen) mit installierten Audio-Paketen:

pip install librosa numpy scipy google-genai

3. Remotion-Browser-Abhängigkeiten: Das Starten von Chrome im Headless-Modus erfordert Chromium. Installieren Sie es über die CLI:

npx @remotion/cli browser ensure

🌐 Remote-MCP / Claude Web & Streamable-HTTP-Bereitstellung

Dieser Server unterstützt die MCP-Streamable-HTTP-Transport-Spezifikation (@modelcontextprotocol/sdk v1.29.0), sodass webbasierte Clients wie Claude Web (https://claude.ai/new) eine Remote-Verbindung herstellen können.

1. Ausführen des HTTP-Servers lokal

Erstellen und starten Sie den Streamable-HTTP-Server:

npm install
npm run build
npm run start:http

Standardmäßig lauscht der Server auf:

• Health-Check: GET http://localhost:3000/health

• MCP-Endpunkt: http://localhost:3000/mcp

2. Umgebungsvariablen

Erstellen Sie eine .env-Datei oder exportieren Sie Umgebungsvariablen:

3. Sichern des HTTP-MCP-Endpunkts

Bei der Bereitstellung auf einem öffentlichen Server konfigurieren Sie MCP_AUTH_TOKEN:

export MCP_AUTH_TOKEN=your-secret-token-here
npm run start:http

Eingehende Anfragen an /mcp müssen den folgenden Header enthalten:

Authorization: Bearer your-secret-token-here

Anfragen mit fehlendem oder ungültigem Token erhalten eine 401 Unauthorized-Antwort.

4. Testen von HTTP- und Health-Endpunkten

• Health-Status überprüfen:

  curl http://localhost:3000/health
  # Response: {"status":"ok","service":"remotion-mcp-server"}

• MCP-Initialisierung überprüfen:

  curl -X POST http://localhost:3000/mcp \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer your-secret-token-here" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "initialize",
      "params": {
        "protocolVersion": "2024-11-05",
        "capabilities": {},
        "clientInfo": { "name": "curl-test", "version": "1.0.0" }
      }
    }'

5. Bereitstellung auf Render (One-Click / Blueprint)

Das Repository enthält ein render.yaml-Blueprint und ein produktionsreifes Dockerfile, das Node 20, Chromium, FFmpeg und Python-Audiobibliotheken bündelt.

1. Pushen Sie Ihr Repository auf GitHub.

2. Melden Sie sich bei Render an und klicken Sie auf Neu + -> Blueprint.

3. Verbinden Sie Ihr Repository (remotionMcpServer). Render erkennt render.yaml automatisch.

4. Konfigurieren Sie Umgebungsvariablen im Render-Dashboard:

   • MCP_AUTH_TOKEN: Ihr benutzerdefinierter geheimer Token.

   • GEMINI_API_KEY: Ihr Gemini-API-Schlüssel.

5. Bereitstellen! Ihre Remote-MCP-URL lautet:

   https://YOUR-SERVICE-NAME.onrender.com/mcp

6. Verbinden mit Claude Web

1. Gehen Sie zu https://claude.ai/new.

2. Öffnen Sie die Einstellungen für benutzerdefinierte MCP-Connectors.

3. Geben Sie Ihre Remote-MCP-URL ein:

   https://YOUR-SERVICE-NAME.onrender.com/mcp

4. Wenn die Authentifizierung aktiviert ist, konfigurieren Sie den Authorization-Header mit Bearer <your-mcp-auth-token>.

5. Speichern und verbinden. Claude Web listet alle 5 verfügbaren Remotion-Tools auf.

💻 Lokales STDIO-Setup (Antigravity & lokale Clients)

Sofortiges Ein-Befehl-Setup (empfohlen)

Kopieren Sie einen einzelnen Befehl und fügen Sie ihn in Ihr Terminal ein:

🍎 macOS / Linux (Terminal)

curl -fsSL https://raw.githubusercontent.com/ivalenzuela/remotion-mcp-server/main/autoinstall.sh | bash

🪟 Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/ivalenzuela/remotion-mcp-server/main/autoinstall.ps1 | iex

Manuelle STDIO-Konfiguration

1. Server kompilieren:

   git clone https://github.com/ivalenzuela/remotion-mcp-server.git
   cd remotion-mcp-server
   npm install
   npm run build

2. In KI-Client registrieren (mcp_config.json / claude_desktop_config.json):

   {
     "mcpServers": {
       "remotion": {
         "command": "node",
         "args": ["/path/to/remotion-mcp-server/dist/index.js"],
         "env": {
           "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE"
         }
       }
     }
   }

🤖 Verfügbare MCP-Tools

Alle fünf Tools sind identisch über STDIO- und Streamable-HTTP-Transporte verfügbar:

1. remotion_scaffold_project

Erstellt ein vollständiges React/Remotion-Projekt mit vorgefertigten Vorlagen, Standard-Layout-Komponenten und installiert automatisch npm-Abhängigkeiten.

• Argumente:

  • projectName (string, erforderlich): Ordnername des Zielprojekts.

  • template (enum: tiktok-916, youtube-169, social-11, erforderlich): Seitenverhältnis.

  • targetDir (string, erforderlich): Pfad des übergeordneten Verzeichnisses.

2. remotion_analyze_audio

Führt Signalverarbeitung an Audiodateien mit Python Librosa durch, um BPM, Beat-Frames, Energieprofile, empfohlene Szenenschnitt-Framenummern zurückzugeben und SRT-Untertitel auszurichten.

• Argumente:

  • audioPath (string, erforderlich): Pfad zur Eingabe-Audiodatei.

  • srtPath (string, optional): Pfad zur SRT-Untertiteldatei.

  • outputPath (string, optional): Pfad zum Speichern der Ausgabe-JSON-Analyse.

  • fps (number, Standard 30): Ziel-Framerate der Komposition.

  • minSceneDuration (number, Standard 3.5): Mindestsekunden zwischen Szenenschnitten.

3. remotion_generate_tts

Synthetisiert Sprache mit Google Gemini 3.1 Flash TTS (gemini-3.1-flash-tts-preview) und gibt zeichengewichtete Wort-Zeitcodes aus. Fällt automatisch auf sauberes synthetisches Audio zurück, wenn GEMINI_API_KEY nicht vorhanden ist.

• Argumente:

  • text (string, erforderlich): Dialogtext, der synthetisiert werden soll.

  • outputPath (string, erforderlich): Pfad zum Speichern der generierten .wav-Datei.

  • voice (string, Standard "Puck"): Vorgefertigter Gemini-Stimmenname.

  • accent (string, optional): Optionale Anweisung für regionalen Akzent.

  • fps (number, Standard 30): Framerate.

4. remotion_preview_frame

Rendert ein Standbild-Snapshot (PNG/JPEG/WebP) eines bestimmten Frames in der Komposition mit der Remotion-CLI.

• Argumente:

  • projectDir (string, erforderlich): Pfad zum Remotion-Projekt.

  • compositionId (string, erforderlich): Ziel-Kompositions-ID.

  • frame (number, Standard 0): Frame-Index, der erfasst werden soll.

  • imageFormat (enum: png, jpeg, webp, Standard png): Format.

  • props (object, optional): Eingabe-React-Props.

5. remotion_render_video

Kompiliert eine Komposition zu einem produktionsreifen Video (MP4/WebM).

• Argumente:

  • projectDir (string, erforderlich): Pfad zum Remotion-Projekt.

  • compositionId (string, erforderlich): Ziel-Kompositions-ID.

  • outputPath (string, optional): Ausgabepfad des Videos.

  • concurrency (number/string, Standard "auto"): Zu verwendende CPU-Threads.

  • codec (string, Standard "h264"): Ziel-Codec.

  • props (object, optional): Eingabe-React-Props.

🎨 Vorgefertigte React-Komponenten

Scaffold-Projekte enthalten diese produktionsreifen Layout-Komponenten:

1. SubtitleOverlay: Wort-für-Wort aktive Skalierung und benutzerdefinierte Textschatten-Glows ("Efecto Lupa PRO") für zweisprachige Untertitel.

2. KenBurnsImage: Saubere interpolationsbasierte Bildskalierung und -verschiebung ohne CSS-Animationen.

3. AudioSpectrum: Klangfrequenzspektrum-Visualisierungsbalken, die reaktiv mit dem Soundtrack synchronisiert sind.

4. LowerThird: Elegante Lower-Third-Einblendungen für Social-Media-Profile oder Namenskarten.

🧪 Tests & Verifizierung

Führen Sie die vollständige E2E-Testsuite aus, um Tool-Ausführung, Pfadauflösung und CLI-Rendering zu verifizieren:

npm test

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.