# 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](https://ffmpeg.org/) instalado e no PATH (inclui ffprobe)

## Instalação

```bash
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`:

```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](https://github.com/modelcontextprotocol/typescript-sdk) · ffmpeg/ffprobe · Node.js