YouTube MCP

jkawamoto/mcp-youtube-transcript· Проверено 12.11.2026· 496на GitHub

Даёт агенту субтитры YouTube-видео: текст целиком, с таймкодами или на нужном языке, плюс название и канал. Длинные расшифровки приходят частями, чтобы влезть в контекст.

2 реализации:

Python-сервер на uvx: режет длинные расшифровки на куски по 50 000 знаков, отдаёт данные о видео и умеет работать через прокси.

Как подключить

Что сделать до подключения

uv с командой uvx; для Claude Desktop есть готовый пакет .mcpb на странице Releases

WEBSHARE_PROXY_USERNAME

по желанию: логин резидентного прокси Webshare, вместе с WEBSHARE_PROXY_PASSWORD

SCRAPINGANT_API_TOKEN

по желанию: токен ScrapingAnt; для YouTube нужна платная подписка на Web Scraping API

HTTPS_PROXY

по желанию: адрес обычного прокси вида http://логин:пароль@хост:порт

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio youtube \
  -- uvx --from git+https://github.com/jkawamoto/mcp-youtube-transcript mcp-youtube-transcript

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.youtube]
command = "uvx"
args = ["--from", "git+https://github.com/jkawamoto/mcp-youtube-transcript", "mcp-youtube-transcript"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "youtube": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "youtube": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "git+https://github.com/jkawamoto/mcp-youtube-transcript",
          "mcp-youtube-transcript"
        ]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "youtube": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jkawamoto/mcp-youtube-transcript",
        "mcp-youtube-transcript"
      ]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_transcriptвыгружает текст субтитров

get_timed_transcriptвыгружает субтитры с таймкодами

get_available_languagesпоказывает доступные языки субтитров

get_video_infoчитает название и канал видео

Node.js-пакет через npx: понимает Shorts и голый ID видео, вырезает рекламные вставки по главам, а с ключом TwelveLabs разбирает картинку видео.

Как подключить

Что сделать до подключения

Node.js 18 или новее

TWELVELABS_API_KEY

по желанию, только для analyze_video: ключ выдают на twelvelabs.io, есть бесплатный тариф

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-server-youtube-transcript \
  -- npx -y @kimtaeyoon83/mcp-server-youtube-transcript

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-server-youtube-transcript]
command = "npx"
args = ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-server-youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-server-youtube-transcript": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-server-youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-server-youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-server-youtube-transcript": {
        "type": "local",
        "command": ["npx", "-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-server-youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-server-youtube-transcript": {
      "command": "npx",
      "args": ["-y", "@kimtaeyoon83/mcp-server-youtube-transcript"]
    }
  }
}

Инструменты сервера

get_transcriptвыгружает субтитры, по желанию с таймкодами

analyze_videoразбирает видеоряд моделью Pegasus

Что попросить агента

«<ссылка на видео> Перескажи главное в пяти пунктах»Агент вызовет get_transcript и перескажет текст; у jkawamoto для длинного видео дочитает остальное через next_cursor

«На какой минуте в <ссылка на видео> говорят про <тема>?»Агент вызовет get_timed_transcript и найдёт фрагмент по таймкодам

«Есть ли у <ссылка на видео> русские субтитры? Выгрузи их»Агент вызовет get_available_languages, затем get_transcript с lang=ru

«<ссылка на видео> Извлеки субтитры»Агент вызовет get_transcript и вернёт текст субтитров

«Что показывают в ролике <прямая ссылка на .mp4>? Речи там нет»Агент вызовет analyze_video с вопросом, если задан TWELVELABS_API_KEY

Для каких задач

Пересказать лекцию, подкаст или доклад по субтитрам

Найти момент в видео по таймкодам и процитировать его

Выгрузить субтитры на нужном языке, включая автоматические

Дочитать расшифровку многочасового видео по частям

Убрать из расшифровки спонсорские вставки по главам

Ограничения

Без субтитров у видео расшифровке взяться неоткуда: сервер читает готовые дорожки, звук не распознаёт

YouTube блокирует автоматические запросы с адресов облачных провайдеров и дата-центров; на сервере в облаке понадобится резидентный прокси

analyze_video принимает только прямую ссылку на файл .mp4, .mov или .webm: страницу просмотра YouTube он не откроет

Язык по умолчанию en: для русских субтитров агент должен передать lang=ru

Если не работает

YouTube отвечает блокировкой RequestBlocked или IpBlocked

Сервер запущен с адреса облака или дата-центра. Задайте резидентный прокси Webshare, токен ScrapingAnt или HTTPS_PROXY в env.

Агент получил только начало расшифровки

Длинный текст режется по 50 000 знаков. Попросите агента дочитать через next_cursor или поставьте --response-limit -1 в args.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
YouTube Transcript MCP Server	jkawamoto	496	локально	не нужен	4	9 ноября 2026
YouTube Transcript Server	kimtaeyoon83	603	локально	не нужен	2	21 июля 2026

Частые вопросы

Чем отличаются два варианта?

jkawamoto ставится через uvx, отдаёт данные о видео, список языков и субтитры с таймкодами отдельным инструментом. kimtaeyoon83 ставится через npx, понимает Shorts и вырезает рекламу, а с ключом TwelveLabs разбирает картинку.

Расшифровка длинного видео обрывается. Что делать?

У jkawamoto ответ режется на куски по 50 000 знаков, следующий кусок агент берёт через next_cursor. Размер куска меняется флагом --response-limit, значение -1 отдаёт текст целиком.

Можно получить субтитры на русском?

Да, агент передаёт код языка в параметре lang. У jkawamoto список языков, ручных и автоматических, показывает get_available_languages; kimtaeyoon83 сам берёт доступный язык, если нужного нет.

Как дать ссылку на видео?

Подойдёт полный адрес видео. Вариант kimtaeyoon83 принимает ещё ссылки на Shorts и голый ID видео.

Работает ли сервер из России?

Сервер работает на вашем компьютере и обращается к YouTube с вашего IP; ключи для субтитров не нужны, прокси задаётся переменными окружения.

YouTube MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы