Video Programado

Um servidor MCP de código aberto que transforma um pedido em linguagem natural num vídeo vertical de motion graphics narrado: voz natural, animação sincronizada palavra por palavra, trilha eletrônica e efeitos sonoros, entregue em MP4 pronto para Reels, TikTok e Shorts.

Você pede para a sua IA ("faça um vídeo de 40 segundos explicando DNS"), ela escreve o roteiro, mostra as cenas e o custo, e o MCP gera o vídeo no seu computador.

English summary below.

Como funciona

1. A IA escreve um roteiro em cenas (fala + tipo de visual).

2. O MCP valida o roteiro e calcula o custo antes de gastar qualquer crédito.

3. A voz é gerada pela API da OpenAI (gpt-4o-mini-tts), e cada palavra recebe o instante exato em que é falada (whisper-1).

4. A animação é montada em código com Remotion: cada palavra entra na tela junto com a voz.

5. Trilha e efeitos são gerados por código, sem direito autoral de terceiros.

6. O MP4 é salvo na sua pasta de vídeos, em video-programado.

Tipos de cena: título com palavras em destaque, terminal e código dentro de um MacBook, lista que acende item a item, número contando, tela de virada na cor de destaque e chamada final "Comente PALAVRA".

Related MCP server: video-render-mcp

Requisitos

• macOS 15 ou mais novo, Windows 10/11 (64 bits) ou Linux. No Mac, o Remotion atual exige macOS 15 (versões anteriores dele têm falhas de segurança conhecidas e não são usadas aqui).

• Node.js 18.18 ou mais novo.

• Um assistente com suporte a MCP: Claude Code, Claude Desktop ou Cursor.

• Uma chave da API da OpenAI com crédito (platform.openai.com). Defina um limite mensal de gasto na conta.

• Cerca de 1 GB livre. Na primeira execução, o Remotion baixa o navegador sem janela que usa para renderizar.

Instalação

Claude Code:

claude mcp add video-programado --env OPENAI_API_KEY=sk-sua-chave -- npx -y github:rafaellinsrj/video-programado

Claude Desktop ou Cursor (arquivo de configuração de MCP):

{
  "mcpServers": {
    "video-programado": {
      "command": "npx",
      "args": ["-y", "github:rafaellinsrj/video-programado"],
      "env": {"OPENAI_API_KEY": "sk-sua-chave"}
    }
  }
}

Reinicie o assistente e peça um vídeo.

Ferramentas do MCP

Linha de comando (sem assistente)

export OPENAI_API_KEY=sk-sua-chave
npx github:rafaellinsrj/video-programado custo roteiro.json
npx github:rafaellinsrj/video-programado criar roteiro.json

Veja o formato em exemplos/exemplo.json.

Configuração opcional

Custo

O projeto é gratuito. O único custo é a API da OpenAI, cobrada por minuto de áudio (preços oficiais conferidos em outubro de 2026): cerca de US$ 0,015 por minuto de voz e US$ 0,006 por minuto de transcrição. Um vídeo de 45 segundos custa cerca de US$ 0,02. O MCP mostra a estimativa antes e recusa vídeos acima do teto.

Segurança

• A chave da OpenAI é lida só da variável de ambiente, nunca é gravada em arquivo e é removida de qualquer log ou mensagem de erro.

• O roteiro é validado com schema estrito e limites antes de qualquer chamada paga.

• O MCP só escreve na pasta de vídeos e numa pasta temporária própria, apagada ao final.

• A única conexão de rede do servidor é com api.openai.com.

• Não coloque dados pessoais sensíveis no roteiro: o texto é enviado à OpenAI para gerar a voz.

Detalhes em docs/MODELO-DE-AMEACAS.md e SECURITY.md.

Desenvolvimento

npm ci
npm test            # testes automáticos (não chamam a API)
npm run check       # tipos das cenas
npm run studio      # prévia das cenas no navegador

Licenças

Código sob licença MIT. Fontes Inter e JetBrains Mono sob SIL Open Font License. O Remotion tem licença própria: gratuito para pessoas e empresas pequenas; empresas maiores precisam de licença da Remotion (remotion.dev/license).

English

Video Programado is an open source MCP server that turns a plain-language request into a narrated vertical motion graphics video (voice, word-synced animation, music and sound effects) rendered locally with Remotion. Voice and word timing use your own OpenAI API key (about US$ 0.02 per 45-second video). Install with:

claude mcp add video-programado --env OPENAI_API_KEY=sk-your-key -- npx -y github:rafaellinsrj/video-programado

Narration languages: Portuguese, English and Spanish. MIT licensed.