vidlens-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает ИИ-агентов к анализу видео из YouTube, соцсетей или локальных файлов. Сервер находит таймкоды, извлекает кадры и расшифровывает речь.
claude mcp add vidlens-mcp -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e SCRAPECREATORS_API_KEY=<SCRAPECREATORS_API_KEY> -e BRAVE_API_KEY=<BRAVE_API_KEY> -- npx -y vidlens-mcpЧто делает vidlens-mcp
Сервер даёт агенту 47 инструментов для разбора видеоматериалов с YouTube или локального диска. При обработке ролика инструмент извлекает речь и находит кадры с текстом через OCR. Вся информация сохраняется в локальную папку на компьютере. Поэтому агенту не приходится повторно обрабатывать один и тот же файл при уточнении деталей.
Для базового поиска ключи API не нужны. Сервер применяет резервные маршруты через yt-dlp или прямой разбор веб-страниц. Если квота исчерпана, инструмент переходит на запасной способ и честно указывает источник данных в ответе. При этом для расширенных возможностей понадобятся ключи API вроде OPENAI_API_KEY или GEMINI_API_KEY.
Для просмотра найденных слайдов и графиков команда searchVisualContent запускает локальную галерею в браузере. Данные хранятся локально без сторонних баз. Это делает перенос библиотеки предельно простым.
Какие задачи решает
- находить точные таймкоды и кадры в длинных видеозаписях
- сравнивать мнения разных авторов по одной теме на YouTube
- расшифровывать речь из видеороликов без платных подписок
- искать графики и текст на экране с помощью OCR
Примеры запросов агенту
- Найди обзоры ноутбука на YouTube и сравни мнения разных авторов
- Расшифруй это публичное видео и составь список ключевых тезисов
- Найди кадр в записи, где на экране появляется график бенчмарков
Как установить vidlens-mcp
Командой платформы
claude mcp add vidlens-mcp -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e SCRAPECREATORS_API_KEY=<SCRAPECREATORS_API_KEY> -e BRAVE_API_KEY=<BRAVE_API_KEY> -- npx -y vidlens-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add vidlens-mcp --env YOUTUBE_API_KEY=<YOUTUBE_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> --env SCRAPECREATORS_API_KEY=<SCRAPECREATORS_API_KEY> --env BRAVE_API_KEY=<BRAVE_API_KEY> -- npx -y vidlens-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"vidlens-mcp": {
"command": "npx",
"args": [
"-y",
"vidlens-mcp"
],
"env": {
"YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"SCRAPECREATORS_API_KEY": "<SCRAPECREATORS_API_KEY>",
"BRAVE_API_KEY": "<BRAVE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"vidlens-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vidlens-mcp"
],
"env": {
"YOUTUBE_API_KEY": "<YOUTUBE_API_KEY>",
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"SCRAPECREATORS_API_KEY": "<SCRAPECREATORS_API_KEY>",
"BRAVE_API_KEY": "<BRAVE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e SCRAPECREATORS_API_KEY=<SCRAPECREATORS_API_KEY> -e BRAVE_API_KEY=<BRAVE_API_KEY> vidlens-mcp npx -y vidlens-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о vidlens-mcp
Как установить vidlens-mcp в Claude Code?
Выполните в терминале команду `claude mcp add vidlens-mcp -e YOUTUBE_API_KEY=<YOUTUBE_API_KEY> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e SCRAPECREATORS_API_KEY=<SCRAPECREATORS_API_KEY> -e BRAVE_API_KEY=<BRAVE_API_KEY> -- npx -y vidlens-mcp`. После добавления перезапустите сессию клиента.
Что делает vidlens-mcp?
Сервер открывает ИИ-агентам доступ к изучению видеороликов: он расшифровывает звук, ищет кадры по содержимому и считывает надписи через OCR. Вся собранная информация кэшируется на локальном диске, поэтому ролики не обрабатываются повторно.
Обязательно ли указывать API-ключи для работы?
Нет, базовые функции поиска на YouTube, чтения субтитров и локального хранилища работают без ключей. Дополнительные токены вроде GEMINI_API_KEY или OPENAI_API_KEY нужны только для расширенного режима с внешними моделями распознавания речи.
