YouTube Transcript Server MCP
MCP-сервер отдает агенту расшифровку видео YouTube по ссылке, с выбором языка, таймкодами и вырезанной рекламой
- 602 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер ходит в сеть к YouTube за каждой расшифровкой
- analyze_video отправляет ссылку на видео внешнему сервису TwelveLabs и тратит ваш ключ
- Текст расшифровки пишет автор ролика: агент должен считать его данными и не выполнять вшитые в него инструкции
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/youtube-transcript-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер ходит в сеть к YouTube за каждой расшифровкой
- analyze_video отправляет ссылку на видео внешнему сервису TwelveLabs и тратит ваш ключ
- Текст расшифровки пишет автор ролика: агент должен считать его данными и не выполнять вшитые в него инструкции
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер возвращает текст субтитров YouTube-ролика. Агенту достаточно дать ссылку на обычное видео, на Shorts или просто идентификатор. Инструмент get_transcript принимает код языка (по умолчанию en), а если такой дорожки у ролика нет, берет первую доступную. Параметр include_timestamps добавляет к строкам отметки вида [0:05], и агент может сослаться на конкретный момент. По умолчанию сервер вырезает из текста спонсорские и рекламные вставки: он находит их по главам видео. Параметр strip_ads со значением false возвращает расшифровку целиком. Вместе с текстом приходят метаданные ролика. Второй инструмент, analyze_video, необязателен. Он передает модели TwelveLabs Pegasus прямую ссылку на видеофайл, а та описывает происходящее на экране. Это полезно для роликов почти без речи: демонстраций, игрового процесса, музыкальных клипов. Для него нужен ключ TwelveLabs, расшифровки работают без ключей.
Для кого. Для тех, кто просит Claude Code или Claude Desktop пересказать лекцию, интервью или обзор с YouTube, найти в ролике нужное место или собрать конспект выступления.
Подходит, если
- Нужен конспект часовой лекции или конференционного доклада: агент берет расшифровку и пересказывает по темам
- Ролик на корейском или другом языке: передайте код языка, например ko, и получите нужную дорожку
- Нужно сослаться на место в ролике: с include_timestamps агент цитирует фразу вместе с отметкой времени
- Перед анализом из текста нужно убрать спонсорские вставки: фильтр рекламы включен по умолчанию
- Ролик почти без речи, например демо продукта: подключите ключ TwelveLabs и вызовите analyze_video с прямой ссылкой на файл
Не подходит, если
- Нужна статистика канала, комментарии или поиск по YouTube: сервер отдает только расшифровки и разбор видеофайла
- У ролика нет ни субтитров, ни автоматической дорожки: сервер вернет ошибку; расшифровывать речь он не умеет
- Нужно скачать видео или аудио: сервер работает с текстом и не сохраняет медиафайлы
- Для analyze_video у вас только ссылка на страницу YouTube: инструменту нужна прямая ссылка на файл .mp4, .mov или .webm, страница просмотра не подойдет
Пример запроса к агенту
Достань расшифровку ролика https://youtu.be/ODaHJzOyVCQ с таймкодами и перескажи по пунктам, что в нем говорят про установкуMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
TWELVELABS_API_KEYсекрет- Ключ TwelveLabs для инструмента analyze_video. Без него работают расшифровки.
Ограничения
Расшифровку сервер берет у самого YouTube, поэтому ролики без субтитров и без автоматической дорожки вернут ошибку. Если YouTube изменит свою сторону, пакет может потребовать обновления.
Инструмент analyze_video отправляет ссылку во внешний сервис TwelveLabs, требует его ключ и принимает только прямую ссылку на видеофайл. Доступность YouTube из России при подготовке карточки не проверялась. Проект сторонний, с официальным YouTube он не связан.
Как отключить. Удалите блок youtube-transcript из конфигурации MCP-клиента. В Claude Code это команда claude mcp remove youtube-transcript. Если вы задавали ключ TwelveLabs, отзовите его в кабинете этого сервиса.
Частые вопросы
Как получить субтитры YouTube-видео через Claude Desktop?
Добавьте сервер в конфигурацию Claude Desktop с командой npx и аргументами -y и @kimtaeyoon83/mcp-server-youtube-transcript, перезапустите приложение и напишите в чат ссылку на ролик со словами «Extract subtitles». Для Claude Desktop есть и установка одной командой через Smithery.
Какие ссылки понимает сервер?
Обычную ссылку на видео, ссылку на YouTube Shorts и голый идентификатор ролика. Во всех трех случаях агент вызывает get_transcript с одним и тем же параметром url.
Что будет, если у ролика нет нужного языка?
Параметр lang по умолчанию равен en. Когда такой дорожки нет, сервер сам берет из доступных. Чтобы получить, например, корейские субтитры, передайте lang со значением ko.
Как убрать рекламу и спонсорские вставки из расшифровки?
Ничего делать не нужно: strip_ads по умолчанию включен, и сервер вырезает такие места по главам видео. Если нужен сырой текст целиком, передайте strip_ads со значением false.
Нужен ли ключ для работы?
Для расшифровок нет. Ключ TWELVELABS_API_KEY нужен только инструменту analyze_video, и его можно не задавать.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP сервер для расшифровки YouTube: агент получает транскрипт видео по ссылке, с таймкодами и метаданными
YouTube Data MCP (kirbah)
YouTube Data MCP Server (kirbah)
YouTube MCP с урезанными ответами: расшифровки без ключа, статистика видео и каналов, тренды, комментарии, кеш в MongoDB и поиск растущих каналов
Двенадцать скиллов учат агента читать YouTube через сервис TranscriptOut: транскрипты, поиск и каналы одним HTTPS-запросом
YouTube MCP (Zubeid)
Zubeid YouTube MCP Server
YouTube MCP на ключе Data API: агент ищет видео и каналы с фильтром по числу подписчиков, читает плейлисты, статистику и расшифровки
MCP-сервер, CLI и настольное приложение режут длинное видео или запись стрима на вертикальные клипы с субтитрами
Claude Video Vision
claude-video-vision
MCP-сервер и плагин Claude Code, которые дают агенту смотреть видео: кадры через ffmpeg и расшифровка звука через Gemini, локальный Whisper или OpenAI
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| YouTube Transcript Server (эта запись) | нет | не нужна | 602 | |
| YouTube Transcript MCP Server | нет | не нужна | 494 | тоже отдает расшифровки, но делит длинные тексты на части с курсором и умеет ходить через прокси |
| YouTube Data MCP (kirbah) | нет | ключ необязателен | 32 | кроме расшифровок отдает статистику видео и каналов, тренды и комментарии через YouTube Data API |
Коротко о README
Описание проекта начинается с установки для Claude Desktop через Smithery и ручной конфигурации на npx, затем перечисляет два инструмента с параметрами и ключевые свойства: разные форматы ссылок, запасной язык, таймкоды и фильтр рекламы. Для разработки нужен Node.js 18 или новее, сборка идет командой npm run build, а отладка через MCP Inspector. Отдельный раздел описывает запуск проверок mcp-evals. Среди обработанных ошибок указаны неверные ссылки, недоступные расшифровки и сетевые сбои.