README

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

mcp-video-vision

README

mcp-video-vision

O que faz

Tools disponíveis

Requisitos

Instalação

Registrar no Claude Code

Uso

Stack

Recommended Servers