119 ferramentas MCP que dão ao seu agente uma superfície real de edição — FFmpeg, legendas, áudio, efeitos, Hyperframes e repurposing. Local, grátis, sem chave de API.
Agentes de IA conseguem escrever comandos FFmpeg, mas não deveriam adivinhar flags, parsear stderr frágil ou publicar mídia silenciosamente quebrada. mcp-video resolve isso.
Validação preflight, checkpoints de qualidade e resultados estruturados impedem que o agente produza mídia quebrada sem perceber.
Edição FFmpeg, planejamento cinematográfico, análise de mídia, legendas, áudio, efeitos, Hyperframes e pacotes de repurposing — tudo acessível via MCP.
Funciona com Claude Code, Claude Desktop, Cursor e qualquer cliente MCP. Inclui também CLI e biblioteca Python para uso sem agente.
O agente descreve o que quer; o mcp-video traduz em operações tipadas, valida parâmetros e retorna resultados estruturados — sem shell-command roulette.
Trim, merge, resize, crop, rotate, transcode, export — com parâmetros validados.
Transcrição IA, SRT, áudio normalizado, waveforms, overlays e síntese local.
Scaffold, inspeção e render de composições Hyperframes diretamente pelo agente.
Um source → Shorts, Reels, TikTok e YouTube com manifesto e artefatos de revisão.
Dependências mínimas para rodar o servidor MCP e as ferramentas de vídeo.
Necessário para rodar o servidor mcp-video. Use pyenv ou a versão do sistema se já for 3.11+.
python --version # 3.11+ pip install mcp-video
Motor de edição de vídeo. Deve estar acessível no PATH.
# macOS brew install ffmpeg # Ubuntu/Debian sudo apt install ffmpeg
Necessário apenas para as ferramentas Hyperframes. Pode pular se não for usar essa funcionalidade.
# verificar node --version # 22+ npm install -g hyperframes
Siga estes passos para conectar o mcp-video ao seu agente e começar a editar.
Instale via pip ou rode sem instalar com uvx. Depois rode o doctor para confirmar que FFmpeg está OK.
# sem instalar globalmente (recomendado para teste) uvx --from mcp-video mcp-video doctor # ou instalar globalmente pip install mcp-video mcp-video doctor
Adicione o servidor MCP com um único comando. O Claude Code detecta e lista as 119 ferramentas automaticamente.
claude mcp add mcp-video -- uvx --from mcp-video mcp-video
Adicione ao arquivo de configuração MCP do cliente (mcpServers em settings.json ou claude_desktop_config.json).
{
"mcpServers": {
"mcp-video": {
"command": "uvx",
"args": ["--from", "mcp-video", "mcp-video"]
}
}
}
Antes de conectar ao agente, rode o workflow de baseline para confirmar que o pipeline funciona de ponta a ponta.
# clone o repo e rode o workflow de confiança git clone https://github.com/inematds/mcp-video cd mcp-video uv run --no-project --with mcp-video \ python workflows/05-confidence-baseline/workflow.py # gera video_receipt.json com resultado verificado
O mcp-video também expõe uma CLI completa para uso manual ou em scripts.
# informações do arquivo mcp-video info video.mp4 # recortar mcp-video trim video.mp4 -s 00:00:10 -d 45 # transcrever e adicionar legendas mcp-video video-ai-transcribe clip.mp4 --output captions.srt mcp-video subtitles clip.mp4 captions.srt # converter para 9:16 (vertical) mcp-video resize clip.mp4 --aspect-ratio 9:16 # repurposing automático mcp-video repurpose clip.mp4 \ --platforms youtube-shorts instagram-reel tiktok
Para pipelines programáticos, use o cliente Python diretamente.
from mcp_video import Client editor = Client() clip = editor.trim("entrevista.mp4", start="00:02:15", duration="00:00:45") captions = editor.ai_transcribe(clip.output_path, output_srt="captions.srt") vertical = editor.resize(clip.output_path, aspect_ratio="9:16") result = editor.release_checkpoint(vertical.output_path) print(result["thumbnail"]) # caminho da thumbnail gerada print(result["storyboard"]) # storyboard do vídeo final
Exemplos de prompts reais que o agente executa com as ferramentas mcp-video.
| Workflow | Exemplo de prompt |
|---|---|
| Clips para redes sociais | "Transforme essa gravação landscape num TikTok e YouTube Short com legendas." |
| Produção de podcast | "Encontre o segmento mais forte, corte, normalize o áudio, adicione capítulos e exporte." |
| Demo de produto | "Crie um vídeo de lançamento com screenshots, title cards e narração." |
| Planejamento cinematográfico | "Crie um style pack e storyboard, depois gere shot prompts para geração." |
| Revisão de qualidade | "Compare esses dois exports, gere thumbnails e aponte problemas visuais ou de áudio." |
| Automação em batch | "Converta essa pasta de clips para MP4 web-ready com loudness consistente." |
| Vídeo via código | "Scaffolde uma composição Hyperframes, inspecione, renderize e adicione legendas." |
| Repurposing local | "Transforme esse master clip em Shorts, Reels, TikTok e YouTube com manifesto." |
Áreas em desenvolvimento ativo e próximas funcionalidades.