mcp-video-vision

MCP server em TypeScript que dá ao Claude a capacidade de "ver" vídeos — extraindo frames e detectando cenas — para uso como ferramenta de edição assistida por IA.

O que faz

Registrado no Claude Code via transporte stdio, expõe ferramentas que permitem ao assistente analisar vídeos sem precisar scrubbar a timeline manualmente.

Tools disponíveis

Tool	Descrição
video_info	Metadata do vídeo (duração, fps, resolução, codec) via ffprobe
extract_frames	Extrai frames por fps fixo ou automático, com controle de resolução e formato
detect_scenes	Detecta cortes de cena via ffmpeg com threshold ajustável
frame_at	Extrai 1 frame de um timestamp exato
decupar	Tool principal: detecta cenas, mescla cortes curtos, extrai 1 frame representativo por plano e devolve log navegável com timecodes

Requisitos

• Node.js 18+
• ffmpeg instalado e no PATH (inclui ffprobe)

Instalação

git clone https://github.com/danusiojr/mcp-video-vision
cd mcp-video-vision
npm install
npm run build

Registrar no Claude Code

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "video-vision": {
      "command": "node",
      "args": ["/caminho/para/mcp-video-vision/dist/index.js"]
    }
  }
}

Uso

Com o server registrado, use no Claude Code:

• "analise o vídeo em /footage/EP011.mp4 e me dê a decupagem completa"
• "quais cenas têm mais de 10 segundos nesse clipe?"
• "extraia o frame do minuto 2:34 desse vídeo"

Stack

TypeScript · @modelcontextprotocol/sdk · ffmpeg/ffprobe · Node.js