remotion-mcp-server

Un servidor MCP (Model Context Protocol) que le da a Claude la capacidad de analizar vídeos de referencia y generar Reels de Instagram / Shorts de YouTube con marca usando Remotion (vídeo programático basado en React) — enteramente desde una conversación de chat.

Señala a Claude un reel de referencia y podrá:

1. Descargarlo (yt-dlp), extraer fotogramas + audio, y obtener una transcripción completa (subtítulos de YouTube primero, faster-whisper como alternativa para todo lo demás — Instagram, TikTok, archivos locales).

2. Generar una nueva composición con el mismo estilo — reels de burbujas de diálogo o reels de datos/listas — como código real de React/TSX.

3. Renderizarlo a MP4 con Remotion.

4. Decirte cómo abrirlo en Remotion Studio para revisarlo antes de darlo por finalizado.

Sin CapCut, sin edición manual — Claude escribe el vídeo.

Herramientas

Ambas herramientas create_* devuelven una pista preview que le dice a Claude/a ti cómo abrir la composición en Remotion Studio (npm run dev → localhost:3000) antes de tratar el render como definitivo.

Related MCP server: cutgent

Configuración

1. Clona e instala las dependencias de Python

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

También necesitarás ffmpeg en tu PATH (o instala imageio-ffmpeg, que el servidor usa automáticamente como alternativa).

2. Configura el proyecto de Remotion

Este servidor necesita un proyecto de Remotion en el que escribir las composiciones generadas y desde el que renderizar. Se incluye un proyecto inicial listo para usar:

cd remotion-template
npm install
cd ..

O apunta REMOTION_MCP_PROJECT a tu propio proyecto de Remotion existente — solo necesita los dos comentarios marcadores de remotion-template/src/Root.tsx presentes en su Root.tsx.

3. Configura (opcional)

Copia .env.example a .env y ajústalo si no usas los valores predeterminados (rutas personalizadas de yt-dlp/ffmpeg, una carpeta de proyecto diferente, una marca de agua predeterminada).

4. Regístrate con Claude

Añade a tu configuración MCP de Claude Desktop / Claude Code:

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

Reinicia Claude y pídele que analice un reel de referencia y te cree uno con el mismo estilo.

Cómo funciona

• analyze_video descarga con yt-dlp, extrae fotogramas + audio con ffmpeg y luego transcribe: subtítulos de YouTube mediante youtube-transcript-api primero, con transcripción local de faster-whisper como alternativa para todo lo demás.

• create_dialogue_reel / create_facts_reel generan una plantilla de archivo de composición .tsx, lo registran en el Root.tsx del proyecto de Remotion entre comentarios marcadores y llaman a npx remotion render.

• Las composiciones generadas aparecen en vivo en Remotion Studio (npm run dev) mediante hot-reload — sin necesidad de reiniciar — para que puedas revisarlas antes de tratar un render como definitivo.

Licencia

MIT — consulta LICENSE.