VideoNote-MCP
MCP-сервер превращает ссылку на видео или подкаст в транскрипт, субтитры и заметку Markdown, добавляя кадры и распознавание речи.
- 103 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скачивает файлы по ссылкам и запускает FFmpeg и распознавание на вашей машине.
- Хранит Cookie и токены платформ в локальном конфиге.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/videonote-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скачивает файлы по ссылкам и запускает FFmpeg и распознавание на вашей машине.
- Хранит Cookie и токены платформ в локальном конфиге.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
VideoNote-MCP собирает материалы для заметки по ссылке на видео или подкаст либо по локальному файлу. Сервер скачивает ролик, берет официальные субтитры платформы, а при их отсутствии запускает распознавание речи. По желанию он вытаскивает ключевые кадры, комментарии и данмаку Bilibili. Инструмент `prepare_note_material` отдает материалы текущему ассистенту, и тот пишет заметку без отдельного ключа LLM. `generate_note` подключает собственную модель как запасной путь, `process_media` экспортирует субтитры в SRT, VTT и JSON. Среди источников Bilibili, YouTube, Douyin, TikTok, Kuaishou, Xiaohongshu и подкасты Xiaoyuzhou.
Для кого. Студентам и авторам, которые конспектируют лекции, подкасты и видеоразборы с помощью агента и хотят Markdown с транскриптом и скриншотами.
Подходит, если
- Лекция или курс на Bilibili и YouTube превращается в конспект с кадрами.
- Запись встречи склеивают из частей, делят по говорящим и оформляют протоколом.
- К роликам нужны субтитры в SRT или VTT для другого инструмента.
- Подкаст в Xiaoyuzhou конспектируют по официальному тексту, без долгой локальной расшифровки.
Не подходит, если
- Видео закрыто логином, а войти в платформу нельзя: для ряда сервисов нужны Cookie.
- Нужен готовый PDF: LaTeX и Typst сервер не компилирует, он дает материалы и шаблоны.
- На компьютере нет FFmpeg и uv, а ставить их нельзя: установщик их не добавляет.
Пример запроса к агенту
Возьми ссылку на лекцию в Bilibili, подготовь материалы с кадрами и составь конспект в Markdown с главами и разделом выводов.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
VIDEONOTE_DATA_DIR- Каталог данных: задачи, заметки, кадры.
VIDEONOTE_CONFIG_DIR- Каталог настроек, входов и моделей.
Ограничения
Нужны Python 3.11–3.13, uv и FFmpeg, их ставят заранее. Для части платформ (AI-субтитры Bilibili, Douyin, Xiaohongshu) требуется вход: `videonote login <платформа>` сохраняет Cookie или токен локально, поэтому лучше взять отдельный аккаунт. По умолчанию ставится faster-whisper, а mlx-whisper, FunASR и разделение говорящих подключают флагом `--with`, одинаковым при установке и в `setup`. Длинные записи распознаются долго. Документация и мастер установки по большей части на китайском, есть README_EN.
Как отключить. Снимите регистрацию через мастер `videonote setup` или командой удаления MCP в вашем клиенте. Данные лежат в `~/.local/share/videonote-mcp/`, их чистит инструмент `cleanup` или ручное удаление.
Частые вопросы
Нужен ли ключ LLM?
Нет. По умолчанию заметку пишет подключенный ассистент по материалам из `prepare_note_material`. Ключ нужен только запасному пути `generate_note`.
Что делать, если платформа просит вход?
Выполните `videonote login bilibili` или команду для нужной платформы. Вход по QR-коду или вставленные Cookie сохраняются только локально.
Куда пишутся результаты?
В папку `note_results/{task_id}/`: `raw/` с исходниками и `gen/` с транскриптом, заметкой и кадрами.
Какие источники поддерживаются?
Bilibili, YouTube, Douyin, TikTok, Kuaishou, Xiaohongshu, подкасты Xiaoyuzhou, а также локальные аудио и видео.
Какие форматы экспорта есть?
Субтитры SRT, VTT и JSON и заметка Markdown. Шаблоны LaTeX и Typst сервер выдает, но сам их не компилирует.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, CLI и настольное приложение режут длинное видео или запись стрима на вертикальные клипы с субтитрами
VidMoat MCP
Vidmoat MCP
Удаленный MCP-сервер облачного видеоредактора: агент загружает материал, правит таймлайн, смотрит кадры и рендерит MP4
MCP-сервер, плагин /video и CLI: расшифровка, ключевые кадры, текст с экрана и метаданные видео из YouTube, Loom, TikTok или файла
Скилл превращает ссылку на видео с Bilibili, Douyin или YouTube в конспект с таймкодами через локальную расшифровку
ClipForge MCP
ClipForge
ClipForge MCP собирает вертикальное видео из темы или ссылки на товар: сток, озвучка Edge TTS и субтитры без ключей, сборка через FFmpeg
MCP-сервер отдает агенту расшифровку видео YouTube по ссылке, с выбором языка, таймкодами и вырезанной рекламой
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| VideoNote-MCP (эта карточка) | нет | не нужна | 103 | |
| video-to-notes | нет | 113 | делает заметки из видео другим конвейером; VideoNote-MCP работает как MCP с платформенными субтитрами и кадрами | |
| yt-dlp-mcp | да | не нужна | 309 | скачивает видео и субтитры; VideoNote-MCP добавляет распознавание, кадры и материалы для заметки |
Коротко о README
README представляет конвейер от ссылки на видео до заметки как MCP-сервер без отдельного бэкенда. Описаны входные данные (ссылки, локальные файлы, готовые субтитры), форматы вывода, два разобранных примера и управление задачами через `list_tasks`, `cleanup` и `health_check`.