convez.ai
MCP ServerDesenvolvimento WebAvançado
PratyushChauhan

Remotion MCP Server

PratyushChauhan/remotion-mcp-server

Geração de vídeos animados automatizada via Claude e Remotion

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP pronto para produção que permite gerar vídeos programaticamente usando Remotion através de agentes Claude. Scaffolda projetos a partir de templates, injeta parâmetros, renderiza vídeos e oferece preview em tempo real via studio.

Instalação

$npx convez-ai PratyushChauhan/remotion-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Renderizar relatórios e dashboards em vídeo de forma automatizada
  • Criar vídeos promocionais e explainers a partir de dados dinâmicos
  • Gerar sequências de animação paramétrizadas sem codificar JSX manualmente
  • Integrar renderização de vídeo em pipelines de automação e agents

Veredito

Ferramenta robusta e bem arquitetada para quem precisa automatizar geração de vídeos via Claude. Exige familiaridade com Node.js, Remotion e MCP, mas oferece controle completo sobre renderização, assets e preview — ideal para pipelines de conteúdo dinâmico e relatórios em vídeo.

README

A tradução para o português deste README ainda está na fila.

Remotion MCP Server

Product-ready MCP server for programmatic video generation using Remotion. Your agent scaffolds projects from templates, injects parameters, renders videos, and serves previews — all through standard MCP tools.

Architecture

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   Claude / IDE  │────▶│   MCP Server     │────▶│  Remotion CLI   │
│   (Client)      │◄────│   (SSE/stdio)    │◄────│  (Render)       │
└─────────────────┘     └──────────────────┘     └─────────────────┘
                               │
                               ▼
                        ┌──────────────┐
                        │  Templates   │
                        │  (intro,     │
                        │   data-kinetic│
                        │   explainer)  │
                        └──────────────┘

Features

  • Template Engine: JSON-parameterized Remotion projects. No JSX code gen needed.
  • Render Queue: Async jobs with progress tracking and status polling.
  • Asset Pipeline: Upload images, fonts, audio via base64.
  • Preview Server: Live remotion studio on demand for iteration.
  • Multi-Transport: stdio for Claude Desktop, SSE for remote/team setups.

Quick Start

1. Install

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

Requires Node.js 18+ and Remotion CLI installed globally:

npm install -g @remotion/cli

2. Run (SSE mode)

npm start
# Server on http://localhost:3000
# SSE endpoint: http://localhost:3000/sse

3. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or equivalent:

{
  "mcpServers": {
    "remotion": {
      "command": "node",
      "args": ["/path/to/remotion-mcp-server/dist/index.js"],
      "env": {
        "REMOTION_WORKSPACE": "/Users/you/remotion-workspace",
        "REMOTION_OUTPUT": "/Users/you/remotion-output"
      }
    }
  }
}

For SSE transport, use an MCP client that supports HTTP SSE (Cursor, custom clients).

MCP Tools

remotion_create_project

Scaffold a new project from a template.

{
  "name": "q3-revenue-video",
  "template": "data-kinetic",
  "params": {
    "title": "Q3 Revenue Report",
    "metrics": [
      { "label": "Revenue", "value": 4.2, "prefix": "$", "suffix": "M" },
      { "label": "Users", "value": 42000 },
      { "label": "Growth", "value": 67, "suffix": "%" }
    ]
  },
  "width": 1920,
  "height": 1080,
  "fps": 30
}

Returns: { projectId, path, message }

remotion_render

Render a composition to MP4.

{
  "projectId": "uuid-here",
  "composition": "DataKinetic",
  "outputFilename": "q3-revenue.mp4",
  "quality": "high"
}

Quality presets: draft (60% JPEG, 2 cores), medium (80%, 4 cores), high (90%, 8 cores), ultra (100%, 16 cores).

Returns: { jobId, status, outputPath }

remotion_get_render_status

Poll render progress.

{ "jobId": "uuid-here" }

Returns: { jobId, status, progress, outputPath, error }

remotion_upload_asset

Upload an image/font/audio asset to a project.

{
  "projectId": "uuid-here",
  "filename": "logo.png",
  "data": "base64-encoded-content"
}

Assets land in public/assets/ and are accessible from compositions via logo.png.

remotion_preview

Start Remotion Studio for live iteration.

{
  "projectId": "uuid-here",
  "port": 3001
}

Returns preview URL. Studio auto-reloads on source changes.

remotion_list_projects

List all active workspaces.

Templates

TemplateUse CaseParameters
introLogo + title revealtitle, subtitle, tagline, backgroundColor, accentColor, logoUrl
data-kineticAnimated metrics/counterstitle, metrics[], backgroundColor, primaryColor, secondaryColor

Templates are full Remotion projects with params.json injection. Add your own by dropping a folder in templates/ with meta.json + standard Remotion boilerplate.

Template System

Adding a Custom Template

  1. Create templates/my-template/:
templates/my-template/
  meta.json          # Template metadata + param schema
  package.json       # Remotion + React deps
  remotion.config.ts # Dimensions, FPS
  tsconfig.json
  src/
    Video.tsx        # Root composition registration
    compositions/
      MyTemplate.tsx # The actual component
  1. meta.json:
{
  "name": "My Template",
  "description": "What it does",
  "params": [
    { "name": "headline", "type": "string", "required": true },
    { "name": "bgColor", "type": "string", "required": false }
  ],
  "defaultParams": {
    "headline": "Default Headline",
    "bgColor": "#000000"
  }
}
  1. Component reads from params.json:
const params = require("../params.json");
// Use params.headline, params.bgColor
  1. Restart server. Template appears in remotion://templates.

Deployment

Docker

FROM node:20-slim
RUN apt-get update && apt-get install -y ffmpeg
RUN npm install -g @remotion/cli
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
RUN npm run build
ENV REMOTION_WORKSPACE=/data/workspaces
ENV REMOTION_OUTPUT=/data/output
VOLUME ["/data"]
EXPOSE 3000
CMD ["node", "dist/index.js"]
docker build -t remotion-mcp .
docker run -p 3000:3000 -v $(pwd)/data:/data remotion-mcp

Systemd

# /etc/systemd/system/remotion-mcp.service
[Unit]
Description=Remotion MCP Server
After=network.target

[Service]
Type=simple
User=remotion
WorkingDirectory=/opt/remotion-mcp-server
ExecStart=/usr/bin/node dist/index.js
Environment=REMOTION_WORKSPACE=/var/lib/remotion/workspaces
Environment=REMOTION_OUTPUT=/var/lib/remotion/output
Restart=always

[Install]
WantedBy=multi-user.target

Environment Variables

VariableDefaultDescription
REMOTION_MCP_PORT3000HTTP server port
REMOTION_WORKSPACE./workspacesProject workspace root
REMOTION_OUTPUT./outputRender output directory

Security Model

  • Workspace isolation: Each project gets a UUID directory. No cross-project access.
  • No sudo: Shell exec limited to Remotion CLI in project directories.
  • No outbound network: Render containers can be sandboxed (Docker).
  • Asset limits: Base64 upload capped by your reverse proxy / Express body parser.

Performance

TemplateDurationHigh Quality Render
intro5s~15s
data-kinetic8s~25s
explainer10s~40s

Renders are CPU-bound. Scale horizontally by running multiple MCP server instances behind a load balancer with a shared Redis queue (swap the in-memory renderJobs map for Bull).

Roadmap

  • Queue backend: Redis/Bull for distributed rendering
  • Webhook callbacks on render completion
  • Template marketplace protocol
  • Real-time progress streaming via SSE
  • Composition hot-reload without restart

License

MIT

Ver o original no GitHub

Bom para

Relacionados