video-watcher MCP server

Un servidor MCP que permite a Claude Desktop "ver" vídeos de YouTube, Instagram, Facebook, o de una URL de vídeo directa (mp4/webm/etc), y responder preguntas sobre ellos.

Lo que hace

Para cualquier URL compatible, el servidor:

1. Descarga el vídeo con yt-dlp (funciona con YouTube, Instagram, Facebook, y cientos de otros sitios, además de recurrir a una descarga HTTP directa para URLs de archivos simples).

2. Extrae una transcripción — subtítulos de YouTube mediante youtube-transcript-api si están disponibles; de lo contrario, transcripción de audio mediante faster-whisper.

3. Extrae 5 fotogramas clave (muestreados a lo largo de la línea temporal del vídeo) como JPEG en base64 usando OpenCV.

Los resultados se guardan en caché en memoria por URL durante toda la vida del proceso, de modo que llamar a varias herramientas sobre el mismo vídeo solo lo descarga/transcribe una vez.

Related MCP server: Video MCP

Herramientas

• watch_video(url) — análisis completo: título, duración, transcripción y fotogramas.

• summarize_video(url) — resumen de ~200 palabras + lista con viñetas de los puntos principales.

• answer_about_video(url, question) — transcripción + fotogramas para que Claude pueda responder a una pregunta específica sobre el vídeo.

Configuración

cd D:\Projects\video-mcp-server
pip install -r requirements.txt

También necesitarás ffmpeg en tu PATH (lo requieren tanto yt-dlp para multiplexar como faster-whisper para la decodificación de audio). En Windows, instálalo mediante winget install ffmpeg o descárgalo desde https://ffmpeg.org y añádelo al PATH.

Prueba primero el servidor de forma independiente:

python video_mcp_server.py

Debería quedarse a la espera en stdio (sin salida = correcto; registra en stderr).

Conectar con Claude Desktop

Edita %APPDATA%\Claude\claude_desktop_config.json (crédalo si no existe) e incorpora lo siguiente:

{
  "mcpServers": {
    "video-watcher": {
      "command": "python",
      "args": ["D:\\Projects\\video-mcp-server\\video_mcp_server.py"]
    }
  }
}

Ajusta la ruta si has clonado esto en otro lugar. Si python no está en el PATH dentro del entorno de Claude Desktop, usa la ruta completa del intérprete, p. ej. "C:\\Users\\<you>\\AppData\\Local\\Programs\\Python\\Python311\\python.exe".

Sal por completo y vuelve a abrir Claude Desktop después de editar la configuración (cerrar la ventana tampoco es suficiente en Windows — usa el icono de la bandeja del sistema para salir).

Probarlo

Prueba lo siguiente una vez conectado:

• watch_video("https://www.youtube.com/watch?v=dQw4w9WgXcQ")

• summarize_video("https://www.youtube.com/shorts/<some-short-id>")

• answer_about_video("https://www.instagram.com/reel/<reel-id>/", "What product is being promoted?")

Pregunta a Claude directamente, p. ej.: "Mira este vídeo y resúmelo: "

Notas y limitaciones

• Instagram: las publicaciones y los reels públicos funcionan mediante yt-dlp. Las cuentas privadas o las publicaciones que requieran iniciar sesión fallarán con un error claro: este servidor no almacena ni utiliza credenciales de Instagram. instagrapi aparece como dependencia opcional para una futura extensión, pero no es necesaria en la ruta de código actual.

• Facebook: solo vídeos públicos; se aplica la misma limitación de inicio de sesión obligatorio.

• Alternativa de Whisper: la primera llamada que necesite transcripción descargará el modelo base de Whisper (~150MB) en el primer uso.

• Límites de frecuencia: las plataformas pueden limitar las solicitudes repetidas; el servidor muestra un error claro de "límite de frecuencia alcanzado, inténtalo más tarde" en lugar de quedarse colgado.

• Almacenamiento: los vídeos descargados se escriben en un directorio de caché temporal (%TEMP%\video_mcp_cache) y no se limpian automáticamente: vacíalo periódicamente si te preocupa el espacio en disco.