mcp-video-analyzer
MCP-сервер, плагин /video и CLI: расшифровка, ключевые кадры, текст с экрана и метаданные видео из YouTube, Loom, TikTok или файла
- 122 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер скачивает видео по ссылкам, которые передает агент, и хранит кадры в кеше на диске
- Переменная MCP_ALLOW_PRIVATE_URLS открывает доступ из агента к адресам локальной сети
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-video-analyzerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер скачивает видео по ссылкам, которые передает агент, и хранит кадры в кеше на диске
- Переменная MCP_ALLOW_PRIVATE_URLS открывает доступ из агента к адресам локальной сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-video-analyzer дает агенту разобрать видео по ссылке или файлу. Инструмент `analyze_video` возвращает расшифровку с отметками времени, ключевые кадры, текст с кадров через OCR, общую временную шкалу и метаданные. Ссылки на YouTube, Vimeo, TikTok, Instagram, X, Twitch, Dailymotion и Facebook читает yt-dlp, ролики Loom, прямые ссылки и локальные файлы сервер берет сам. Всего инструментов восемь. `get_transcript` отдает только текст, `get_metadata` метаданные с комментариями и главами, `get_frame_at` один кадр по времени, `analyze_moment` подробный разбор отрезка. Если нативной расшифровки нет, звук расшифровывает Whisper. Подключить можно тремя способами: плагин `/video` для Claude Code, обычный MCP для любого клиента или скилл с CLI для Codex, Cursor и агентов без MCP. Сервер ходит только на публичные адреса.
Для кого. Разработчикам и аналитикам, которые отдают агенту записи экрана, туториалы и баг-репорты на видео и хотят получить текст и кадры.
Подходит, если
- Баг записан на Loom, и агенту надо понять, на какой секунде ломается интерфейс
- В YouTube-обзоре ищут момент, где автор показывает конкретную настройку
- Из записи созвона нужна расшифровка с отметками времени и текстом из слайдов
- Пачку роликов надо разобрать с возможностью продолжить после сбоя: `analyze_videos`
Не подходит, если
- Видео лежит в закрытой сети или на локальном сервере: по умолчанию частные адреса заблокированы
- Нужно сохранить целый аккаунт с рилсами и сделать по нему базу знаний: для этого автор указывает отдельный проект `social-knowledge-base`
- Нет возможности поставить Node.js 22.12 или новее
Пример запроса к агенту
Проанализируй видео https://youtu.be/jNQXAC9IVRw: дай расшифровку и скажи, что показано на 0:10.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
TWELVELABS_API_KEYсекрет- Ключ TwelveLabs для анализа прямых ссылок моделью Pegasus.
MCP_ALLOW_PRIVATE_URLS- Значение 1 разрешает частные и локальные адреса.
Ограничения
Нужен Node.js 22.12 или новее. Для YouTube, Instagram, TikTok и подобных ссылок обязателен yt-dlp, без него сервер выдает предупреждение. Расшифровку без субтитров делает Whisper, качество зависит от модели, а при опциональном TwelveLabs Pegasus текст получает модель с таймингом, возможны пропуски. Сервер пропускает только публичные адреса. Частные сети открывает переменная `MCP_ALLOW_PRIVATE_URLS`, и тогда агент получает доступ к устройствам локальной сети. Кадры из CLI остаются в каталоге кеша, пока вы их не удалите.
Как отключить. Удалите запись сервера из настроек MCP или плагин `video` командой /plugin. Кеш кадров лежит в каталоге кеша пользователя в папке mcp-video-analyzer, очистите его вручную.
Частые вопросы
Как поставить плагин /video в Claude Code?
Выполните `/plugin marketplace add guimatheus92/mcp-video-analyzer`, затем `/plugin install video@mcp-video-analyzer`. Команда `/video` появится сразу, MCP-сервер регистрируется автоматически.
Как использовать его в Codex или Cursor без MCP?
Выполните `npx skills add guimatheus92/mcp-video-analyzer`. Скилл `video` встанет во все найденные агенты и вызовет встроенный CLI: `npx -y mcp-video-analyzer@latest analyze "<ссылка>"`.
Что будет, если не установить yt-dlp?
Прямые ссылки и локальные файлы работают, кадры берет встроенный `ffmpeg`. Для YouTube, TikTok и других платформ сервер выдаст предупреждение с просьбой поставить yt-dlp, расшифровка и метаданные от него не зависят.
Как разрешить локальные адреса?
Задайте переменную окружения `MCP_ALLOW_PRIVATE_URLS=1`. Адреса метаданных облачных сервисов остаются закрытыми даже с ней.
Какие уровни детализации есть?
Три: `brief` отдает метаданные и расшифровку без кадров, `standard` работает по умолчанию, `detailed` собирает больше кадров. Число кадров можно задать флагом `--max-frames` от 1 до 60.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер отдает агенту расшифровку видео YouTube по ссылке, с выбором языка, таймкодами и вырезанной рекламой
Claude Video Vision
claude-video-vision
MCP-сервер и плагин Claude Code, которые дают агенту смотреть видео: кадры через ffmpeg и расшифровка звука через Gemini, локальный Whisper или OpenAI
MCP сервер для расшифровки YouTube: агент получает транскрипт видео по ссылке, с таймкодами и метаданными
watch-cli, скилл и CLI, дает агенту кадры и расшифровку любого соцвидео, чтобы тот разобрал ролик сам.
YouTube Data MCP (kirbah)
YouTube Data MCP Server (kirbah)
YouTube MCP с урезанными ответами: расшифровки без ключа, статистика видео и каналов, тренды, комментарии, кеш в MongoDB и поиск растущих каналов
Cloudglue MCP — анализ видео для агента
Cloudglue MCP Server
Агент в Cursor или Claude Desktop описывает видео, режет его на главы и кадры и ищет моменты по речи и картинке через Cloudglue
Коротко о README
README сначала объясняет, чем сервер отличается от других: расшифровка, кадры и метаданные в одном инструменте. Затем идут установка для Claude Code, VS Code, Cursor, Claude Desktop и CLI, таблица из восьми инструментов с примерами, уровни детализации, кеш с возможностью продолжить обработку и поддерживаемые источники. Отдельный раздел описывает защиту от обращений к частным сетям и цепочку Whisper.