VideoSeek

videoseek-mcp

Encontre qualquer coisa em qualquer vídeo. Busca semântica em vídeos, perguntas e respostas sobre vídeos, memória persistente e importação de mídias sociais — tudo como ferramentas MCP para seu agente de IA.

O que ele pode fazer?

Dê ao seu agente de IA (Claude, Cursor, Windsurf, etc.) a capacidade de:

• Busque vídeos por significado — "encontre o momento em que alguém abre o presente" em toda a sua biblioteca
• Faça perguntas sobre vídeos — conversas de múltiplas etapas com um vídeo ou toda a sua coleção
• Lembre-se de tudo — memória persistente de texto + vídeo que nunca esquece (Geração Aumentada por Memória)
• Importe de mídias sociais — puxe e indexe conteúdo do TikTok, YouTube, Instagram e mais de 15 plataformas
• Analise em tempo real — descreva qualquer vídeo ou imagem a partir de URL sem fazer upload
• Transcreva — obtenha descrições de cenas visuais ou transcrições de fala

Início Rápido

1. Obtenha uma chave de API

Cadastre-se em memories.ai e pegue sua chave na página de chaves de API. O plano gratuito inclui 100 créditos/mês.

2. Instalação

git clone https://github.com/kennyzheng-builds/videoseek-mcp.git
cd videoseek-mcp
npm install --include=dev
npm run build

3. Conecte ao seu cliente de IA

Claude Desktop

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "videoseek": {
      "command": "node",
      "args": ["/path/to/videoseek-mcp/build/index.js"],
      "env": {
        "MEMORIES_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Adicione em .cursor/mcp.json:

{
  "mcpServers": {
    "videoseek": {
      "command": "node",
      "args": ["/path/to/videoseek-mcp/build/index.js"],
      "env": {
        "MEMORIES_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

export MEMORIES_API_KEY="your-api-key"
claude mcp add videoseek -- node /path/to/videoseek-mcp/build/index.js

Ferramentas (18)

Gerenciamento de Vídeo

Ferramenta	O que faz
upload_video	Envia e indexa um vídeo a partir de URL
list_videos	Lista todos os vídeos indexados
get_video_status	Verifica o status do processamento
delete_videos	Remove vídeos da sua biblioteca
get_transcription	Obtém transcrição visual ou de áudio

Busca

Ferramenta	O que faz
search_videos	Busca semântica em sua biblioteca de vídeos privada
search_public	Busca no TikTok, YouTube, Instagram por significado
search_audio	Encontra quando algo foi dito em um vídeo

Perguntas e Respostas sobre Vídeos

Ferramenta	O que faz
chat_with_video	Faça perguntas sobre vídeos específicos (múltiplas etapas)
chat_personal	Faça perguntas em toda a sua biblioteca + memórias

Memória Persistente

Ferramenta	O que faz
add_memory	Armazena texto com indexação semântica
search_memories	Encontra memórias relevantes por significado
list_memories	Lista todas as memórias armazenadas

Análise de Visão

Ferramenta	O que faz
caption_video	Analisa um vídeo a partir de URL (sem necessidade de upload)
caption_image	Analisa uma imagem a partir de URL

Importação de Mídias Sociais

Ferramenta	O que faz
import_from_url	Importa de qualquer URL de mídia social
import_by_hashtag	Importa por hashtag do TikTok/YouTube/Instagram
import_by_creator	Importa do perfil de um criador

Recursos e Prompts

Recursos: memories://videos (sua biblioteca), memories://memories (seu conhecimento armazenado)

Modelos de prompt: analyze-video, social-media-research, build-knowledge-base

Exemplos de Conversas

"Encontre um momento"

Você: Encontre todos os momentos em que alguém está cozinhando macarrão

O agente usa search_videos → retorna segmentos de vídeo com carimbo de tempo

"Entenda um vídeo"

Você: O que está acontecendo neste vídeo? [URL]

O agente usa caption_video → análise instantânea sem upload

"Pesquise no TikTok"

Você: Pesquise tendências de IA no TikTok

O agente usa search_public → import_from_url → chat_personal para obter insights

"Construa conhecimento"

Você: Resuma todas as minhas gravações de reuniões

O agente usa list_videos → get_transcription → add_memory para obter principais conclusões

Como Ele Se Compara

Recurso	videoseek-mcp	TwelveLabs MCP
Memória persistente (texto + vídeo)	Sim	Não
Importação de mídias sociais (15+ plataformas)	Sim	Não
Geração Aumentada por Memória	Sim	Não
Plano gratuito	100 créditos/mês	10 horas
Perguntas e respostas em múltiplos vídeos	Sim	Sim
Busca semântica	Sim	Sim

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
MEMORIES_API_KEY	Sim	—	Chave de API de memories.ai
MEMORIES_UNIQUE_ID	Não	"default"	Namespace para isolamento multi-tenant

Desenvolvimento

npm install --include=dev
npm run build          # compile TypeScript
npm run dev            # watch mode
npx @modelcontextprotocol/inspector node build/index.js   # test interactively

Arquitetura

videoseek-mcp/
├── src/
│   ├── index.ts     # MCP server — 18 tools, 2 resources, 3 prompts
│   └── client.ts    # Video understanding API client
├── build/           # Compiled JS (generated)
├── package.json
└── tsconfig.json

TypeScript + esquemas Zod + transporte stdio. Sem dependências além do SDK MCP.

Licença

MIT