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.
Настройка клиентов
{
"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@latestVS 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.
OpenScreen
Запись экрана и видеоредактор: агенты записывают, обрезают, масштабируют, добавляют субтитры и экспортируют видео.
ffmpeg-skill
Локальные инструменты FFmpeg для видео и аудио.
davinci-resolve-mcp
Интеграция с DaVinci Resolve: монтаж, цветокоррекция, медиа и проекты.