mcp-video-analyzer

mcp-video-analyzer — MCP-сервер сообщества (автор — guimatheus92). Анализ видео: расшифровка, ключевые кадры, OCR и таймлайн. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
guimatheus92
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
typescript

Уровень риска: high

Скачивает видео, читает локальные файлы, пишет кадры в кэш и (опционально) файлы рядом с видео; может использовать cookies браузера для yt-dlp.

Настройка клиентов

cursor
{
    "code": "{\n  \"servers\": {\n    \"mcp-video-analyzer\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"mcp-video-analyzer@latest\"]\n    }\n  }\n}",
    "lang": "json",
    "notes": "Settings → MCP Servers → Add",
    "verified": "docs"
}

Что умеет

mcp-video-analyzer превращает любое видео — YouTube, Instagram, TikTok, Loom, X, Vimeo, прямые ссылки и локальные файлы — в расшифровку, ключевые кадры, распознанный текст (OCR) и метаданные для ИИ-агентов. По словам автора, это первый видео-MCP, который объединяет расшифровку, кадры и метаданные в одном инструменте. Поддерживаются Loom, платформы yt-dlp (YouTube, Vimeo, TikTok, Instagram, X, Twitch, Dailymotion, Facebook), прямые ссылки на видео и локальные файлы.

Восемь инструментов — ассистент сам выбирает самый дешёвый под задачу:

  • analyze_video — полный анализ: расшифровка с таймкодами и спикерами, ключевые кадры по смене сцен (с удалением дублей), OCR с кадров (код, ошибки, текст интерфейса, цены и даты), общая хронология, метаданные, комментарии, главы и краткое содержание, если есть;
  • analyze_videos — пакетный анализ списка источников с ограничением параллельности и возобновлением;
  • get_transcript — только расшифровка: родные субтитры или Whisper как запасной вариант;
  • get_metadata — метаданные, комментарии и главы без загрузки видео;
  • get_frames — только кадры: по смене сцен или плотно, кадр в секунду;
  • analyze_moment — подробный разбор отрезка времени;
  • get_frame_at и get_frame_burst — кадр в заданный момент или серия кадров в узком окне (анимация, движение).

Расшифровка берётся из загруженных субтитров, затем автоматических, затем из файлов .vtt или .srt рядом с видео; если их нет — звук распознаётся Whisper. Результаты кэшируются в памяти на 10 минут; с MCP_WRITE_SIDECARS=1 они сохраняются рядом с локальными видео, чтобы большие пакеты можно было возобновлять. Необязательно можно подключить анализ TwelveLabs Pegasus через TWELVELABS_API_KEY.

Кому подойдёт

  • Разработчикам и тестировщикам: разбор записей экрана с ошибками интерфейса.
  • Маркетологам и исследователям: анализ роликов из соцсетей и комментариев.
  • Тем, кто обрабатывает большие видеоархивы пакетно.

Похожие серверы — в категории медиа и творчество.

Установка

Нужен Node.js 22.12+. Для YouTube, Vimeo, TikTok, Instagram, X, Twitch, Dailymotion и Facebook обязателен yt-dlp (pip install yt-dlp); Chrome или Chromium — необязательный запасной вариант для кадров. Без них прямые ссылки и локальные файлы всё равно обрабатываются встроенным ffmpeg. Для Claude Code рекомендуется плагин /video из маркетплейса guimatheus92/mcp-video-analyzer — он сам регистрирует MCP-сервер. Для Codex, Cursor, Copilot и Gemini CLI есть навык: npx skills add guimatheus92/mcp-video-analyzer.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add video-analyzer -- npx mcp-video-analyzer@latest

VS Code хранит конфиг в ~/.vscode/mcp.json (в Windows — %APPDATA%\Code\User\mcp.json); в Cursor сервер добавляется через Settings → MCP Servers → Add. Конфиг Claude Desktop — claude_desktop_config.json. После правки перезапустите клиент или перезагрузите окно.

Проверка

Попросите: «Проанализируй это видео: https://www.youtube.com/watch?v=jNQXAC9IVRw» — сработает analyze_video.

Примеры задач

Вот запись экрана ~/Movies/screen-recording.mp4 — в какой момент ломается интерфейс и какой текст ошибки виден?
Проанализируй все .mp4 в этой папке и составь таблицу с темой и длительностью каждого.

Риски

  • Файлы на диске. Сервер читает локальные видео, сохраняет кадры в кэш, а с MCP_WRITE_SIDECARS=1 пишет файлы рядом с видео (существующие .vtt не перезаписываются).
  • Cookies браузера. Для Instagram и видео с возрастным ограничением можно передать cookies через YTDLP_COOKIES или YTDLP_COOKIES_FROM_BROWSER — это доступ к вашей сессии, храните файл в безопасном месте.
  • Внешний сервис. С TWELVELABS_API_KEY видео анализируются на стороне TwelveLabs.

Частые вопросы

Нужен ли yt-dlp?

Да, для YouTube, TikTok, Instagram и других платформ; для локальных файлов и прямых ссылок — нет.

Как получается расшифровка без субтитров?

Звук распознаётся Whisper; немые дорожки пропускаются с предупреждением.

Можно ли без MCP?

Да, команда npx -y mcp-video-analyzer@latest analyze с адресом видео выдаёт результат в JSON.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

FunASR

Локальная расшифровка аудио моделями FunASR и SenseVoice.

Риск: medium Лицензия: MIT ★ 20 999

OpenScreen

Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.

Риск: medium Лицензия: MIT ★ 7 025

ffmpeg-skill

Локальные инструменты FFmpeg для видео и аудио.

Риск: medium Лицензия: MIT ★ 4 730

davinci-resolve-mcp

Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.

Риск: medium Лицензия: MIT ★ 4 003

Источники