Remotion MCP Server
PratyushChauhan/remotion-mcp-server
Geração de vídeos animados automatizada via Claude e Remotion
Ver no GitHubServidor 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-server1 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
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 studioon 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
| Template | Use Case | Parameters |
|---|---|---|
intro | Logo + title reveal | title, subtitle, tagline, backgroundColor, accentColor, logoUrl |
data-kinetic | Animated metrics/counters | title, 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
- 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
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"
}
}
- Component reads from
params.json:
const params = require("../params.json");
// Use params.headline, params.bgColor
- 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
| Variable | Default | Description |
|---|---|---|
REMOTION_MCP_PORT | 3000 | HTTP server port |
REMOTION_WORKSPACE | ./workspaces | Project workspace root |
REMOTION_OUTPUT | ./output | Render 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
| Template | Duration | High Quality Render |
|---|---|---|
| intro | 5s | ~15s |
| data-kinetic | 8s | ~25s |
| explainer | 10s | ~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