video-watcher MCP-сервер

MCP-сервер, который позволяет Claude Desktop «смотреть» видео с YouTube, Instagram, Facebook или по прямой ссылке на видео (mp4/webm и т. д.) и отвечать на вопросы о них.

Что он делает

Для любого поддерживаемого URL сервер:

1. Скачивает видео с помощью yt-dlp (работает для YouTube, Instagram, Facebook и сотен других сайтов, а для простых файловых URL в качестве запасного варианта использует обычную HTTP-загрузку).

2. Извлекает транскрипт — субтитры YouTube через youtube-transcript-api, если они доступны, в противном случае транскрибацию аудио через faster-whisper.

3. Извлекает 5 ключевых кадров (выбранных по всей временной шкале видео) в виде base64 JPEG с помощью OpenCV.

Результаты кэшируются в памяти для каждого URL на время жизни процесса, поэтому вызов нескольких инструментов для одного и того же видео загружает/транскрибирует его только один раз.

Related MCP server: Video MCP

Инструменты

• watch_video(url) — полный анализ: название, длительность, транскрипт, кадры.

• summarize_video(url) — краткое содержание примерно на 200 слов + маркированный список основных тезисов.

• answer_about_video(url, question) — транскрипт + кадры, чтобы Claude мог ответить на конкретный вопрос о видео.

Установка

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

Вам также понадобится ffmpeg в вашем PATH (требуется и для yt-dlp при мультиплексировании, и для faster-whisper при декодировании аудио). В Windows установите через winget install ffmpeg или скачайте с https://ffmpeg.org и добавьте в PATH.

Сначала протестируйте сервер отдельно:

python video_mcp_server.py

Он должен ожидать ввода через stdio (нет вывода — это хорошо; он пишет логи в stderr).

Подключение к Claude Desktop

Отредактируйте %APPDATA%\Claude\claude_desktop_config.json (создайте его, если его нет) и добавьте:

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

Измените путь, если вы клонировали его в другое место. Если python не находится в PATH в окружении Claude Desktop, используйте полный путь к интерпретатору, например "C:\\Users\\<you>\\AppData\\Local\\Programs\\Python\\Python311\\python.exe".

Полностью завершите работу Claude Desktop и откройте его заново после редактирования конфигурации (закрытия окна недостаточно и в Windows тоже — используйте значок в системном трее, чтобы выйти).

Тестирование

Попробуйте следующее после подключения:

• 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?")

Спросите Claude напрямую, например: «Посмотри это видео и сделай его краткое содержание: »

Примечания и ограничения

• Instagram: публичные посты/рилсы работают через yt-dlp. Частные аккаунты или посты, требующие входа, завершатся с понятной ошибкой — этот сервер не хранит и не использует учётные данные Instagram. instagrapi указан как опциональная зависимость для будущего расширения, но не требуется текущим кодом.

• Facebook: только публичные видео; действует то же ограничение, связанное с необходимостью входа.

• Запасной вариант Whisper: первый вызов, которому нужна транскрибация, загрузит модель Whisper base (~150 МБ) при первом использовании.

• Ограничения частоты запросов: платформы могут ограничивать повторные запросы; сервер выдаёт понятную ошибку «превышен лимит запросов, попробуйте позже», а не зависает.

• Хранилище: загруженные видео записываются во временный каталог кэша (%TEMP%\video_mcp_cache) и не очищаются автоматически — периодически очищайте его, если важен объём диска.