mcp-youtube-transcript — MCP-сервер для Claude Code: установка
MCP-сервер для извлечения текстовых субтитров, таймкодов и метаданных из роликов на YouTube. Помогает агентам разбирать длинные видеозаписи без перегрузки контекста.
Открыть на GitHubЧто делает mcp-youtube-transcript
Сервер регистрирует четыре инструмента: get_transcript для сплошного текста, get_timed_transcript для фрагментов с временными метками, get_available_languages и get_video_info. С их помощью ассистент получает расшифровку речи, длительность отрезков и название канала. Нужный язык субтитров задаётся параметром lang.
Тексты длиннее 50 000 символов сервер автоматически делит на части. Агент получает токен next_cursor и последовательно подгружает продолжение. Лимит символов меняется аргументом --response-limit, а отрицательное число полностью выключает разбивку. При частых обращениях YouTube блокирует сетевые запросы дата-центров, поэтому в конфигурации предусмотрено подключение прокси Webshare или ScrapingAnt.
Без установленного в системе менеджера uv запустить процесс через uvx не выйдет.
Какие задачи решает
- Получать текстовую стенограмму видеоролика на YouTube по ссылке
- Извлекать субтитры с точными временными метками и длительностью фраз
- Проверять перечень доступных языковых дорожек у видео
- Загружать расшифровки длинных записей частями через курсорную пагинацию
- Обходить блокировки YouTube по сетевому адресу с помощью прокси
Примеры запросов агенту
- Загрузи текстовую расшифровку для ролика
<url>. - Покажи субтитры с таймкодами для видео
<url>на английском языке. - Проверь, какие языки субтитров доступны для ролика
<url>.
Как установить mcp-youtube-transcript
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-youtube-transcript
Как установить mcp-youtube-transcript?
В конфигурационный файл клиента в секцию mcpServers добавляется команда uvx с аргументами --from, git+https://github.com/jkawamoto/mcp-youtube-transcript, mcp-youtube-transcript. В системе должен быть заранее установлен инструмент uv.
Что делает mcp-youtube-transcript?
Сервер извлекает текст субтитров, таймкоды и метаданные видео по ссылке на YouTube. Он разбивает большие стенограммы на фрагменты по 50 000 символов и поддерживает работу через внешние прокси.
Как отключить разбиение субтитров на части?
Передайте флаг --response-limit с отрицательным числом, например -1. Тогда сервер отдаст всю стенограмму целиком за один ответ.
