VideoSeek

videoseek-mcp

Encuentra cualquier cosa en cualquier video. Búsqueda semántica de videos, preguntas y respuestas sobre videos, memoria persistente e importación de redes sociales, todo como herramientas MCP para tu agente de IA.

¿Qué puede hacer?

Dale a tu agente de IA (Claude, Cursor, Windsurf, etc.) la capacidad de:

• Buscar videos por significado — "encuentra el momento en que alguien abre el regalo" en toda tu biblioteca
• Hacer preguntas sobre videos — conversaciones de múltiples turnos con un video o toda tu colección
• Recordar todo — memoria persistente de texto + video que nunca olvida (Generación Aumentada por Memoria)
• Importar desde redes sociales — extrae e indexa contenido de TikTok, YouTube, Instagram y más de 15 plataformas
• Analizar sobre la marcha — describe cualquier video o imagen desde URL sin subir
• Transcribir — obtén descripciones de escenas visuales o transcripciones de palabras habladas

Inicio rápido

1. Obtén una clave API

Regístrate en memories.ai y obtén tu clave desde la página de claves API. El plan gratuito incluye 100 créditos al mes.

2. Instalación

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

3. Conéctalo a tu cliente de IA

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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

Añade a .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

Herramientas (18)

Gestión de videos

Herramienta	Qué hace
upload_video	Sube e indexa un video desde URL
list_videos	Lista todos los videos indexados
get_video_status	Comprueba el estado de procesamiento
delete_videos	Elimina videos de tu biblioteca
get_transcription	Obtén transcripción visual o de audio

Búsqueda

Herramienta	Qué hace
search_videos	Búsqueda semántica en tu biblioteca de videos privada
search_public	Busca en TikTok, YouTube, Instagram por significado
search_audio	Encuentra cuándo se dijo algo en un video

Preguntas y respuestas sobre videos

Herramienta	Qué hace
chat_with_video	Haz preguntas sobre videos específicos (múltiples turnos)
chat_personal	Haz preguntas en toda tu biblioteca + recuerdos

Memoria persistente

Herramienta	Qué hace
add_memory	Almacena texto con indexación semántica
search_memories	Encuentra recuerdos relevantes por significado
list_memories	Lista todos los recuerdos almacenados

Análisis de visión

Herramienta	Qué hace
caption_video	Analiza un video desde URL (sin necesidad de subir)
caption_image	Analiza una imagen desde URL

Importación de redes sociales

Herramienta	Qué hace
import_from_url	Importa desde cualquier URL de redes sociales
import_by_hashtag	Importa por hashtag desde TikTok/YouTube/Instagram
import_by_creator	Importa desde el perfil de un creador

Recursos y avisos

Recursos: memories://videos (tu biblioteca), memories://memories (tu conocimiento almacenado)

Plantillas de avisos: analyze-video, social-media-research, build-knowledge-base

Ejemplos de conversaciones

"Encuentra un momento"

Tú: Encuentra todos los momentos donde alguien está cocinando pasta

El agente usa search_videos → devuelve segmentos de video con marcas de tiempo

"Entiende un video"

Tú: ¿Qué está pasando en este video? [URL]

El agente usa caption_video → análisis instantáneo sin subir

"Investiga TikTok"

Tú: Investiga tendencias de IA en TikTok

El agente usa search_public → import_from_url → chat_personal para obtener información

"Construye conocimiento"

Tú: Resume todas mis grabaciones de reuniones

El agente usa list_videos → get_transcription → add_memory para obtener conclusiones clave

Cómo se compara

Característica	videoseek-mcp	TwelveLabs MCP
Memoria persistente (texto + video)	Sí	No
Importación de redes sociales (más de 15 plataformas)	Sí	No
Generación Aumentada por Memoria	Sí	No
Plan gratuito	100 créditos/mes	10 horas
Preguntas y respuestas multi-video	Sí	Sí
Búsqueda semántica	Sí	Sí

Variables de entorno

Variable	Requerida	Predeterminado	Descripción
MEMORIES_API_KEY	Sí	—	Clave API de memories.ai
MEMORIES_UNIQUE_ID	No	"default"	Espacio de nombres para aislamiento multi-tenant

Desarrollo

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

Arquitectura

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. Sin dependencias más allá del SDK de MCP.

Licencia

MIT