youtube-mcp

YouTube MCP с аутентификацией OAuth для владельцев каналов. Редактируйте метаданные видео, отвечайте на комментарии и модерируйте их, управляйте плейлистами, запрашивайте аналитику канала, а также создавайте или устанавливайте AI-превью через мост с ComfyUI. Выходит далеко за рамки обычных оберток Data API v3 с доступом только для чтения, которые доминируют в этой сфере.

Основная идея

Большинство существующих MCP для YouTube используют API-ключ для работы с Data API v3. Поиск видео, получение публичных метаданных — только чтение. Этот сервер использует OAuth 2.0 (Authorization Code + PKCE), поэтому он может реально вносить изменения на ваш канал: обновлять названия, описания и теги видео, отвечать на комментарии, модерировать спам, управлять плейлистами. Он также обращается к отдельному YouTube Analytics API для получения статистики канала и генерирует превью через ComfyUI, отправляя его на YouTube одним вызовом MCP.

Claude, use generate_and_set_thumbnail on video abc123:
  prompt: "cyberpunk hacker at keyboard, neon blue and pink, high contrast"

ComfyUI выполняет рендеринг в 1280×720, youtube-mcp получает байты и отправляет их через POST в thumbnails.set. Готово.

Related MCP server: yt-fetch

Установка

# npx, no install
npx @miller-joe/youtube-mcp --help

# Docker
docker run -p 9120:9120 \
  -e YOUTUBE_CLIENT_ID=... \
  -e YOUTUBE_CLIENT_SECRET=... \
  -e YOUTUBE_TOKEN_FILE=/token/token.json \
  -v $PWD/token:/token \
  ghcr.io/miller-joe/youtube-mcp:latest

Настройка: Google Cloud (однократно, ~10 мин)

1. Аккаунт Google и YouTube-канал. Используйте личный аккаунт, а не рабочий, к которому вы можете потерять доступ.

2. Проект Google Cloud на https://console.cloud.google.com. Назовите его как угодно (например, youtube-mcp).

3. Включите API:

   • YouTube Data API v3

   • YouTube Analytics API

4. Экран согласия OAuth: Внешний (External), название приложения, контактный email. В разделе Scopes (Области доступа) добавьте:

   • youtube.upload

   • youtube.force-ssl

   • yt-analytics.readonly

5. Оставайтесь в режиме Тестирования (Testing). Добавьте себя в качестве тестового пользователя (обязательно). Поскольку вы являетесь владельцем проекта, ваш токен обновления (refresh token) не истечет.

6. Создайте идентификатор клиента OAuth: Тип приложения = Desktop app. Скачайте JSON-файл.

7. Запустите интерактивный процесс авторизации:

   npx @miller-joe/youtube-mcp --auth --client-secret-file ./client_secret.json

   Откроется браузер, вы войдете в аккаунт Google, привязанный к вашему YouTube-каналу, и предоставите запрошенные права доступа. В случае успеха токен обновления будет сохранен в ~/.config/youtube-mcp/token.json.

8. Запустите сервер:

   npx @miller-joe/youtube-mcp --client-secret-file ./client_secret.json

   Или передайте учетные данные клиента через переменные окружения: YOUTUBE_CLIENT_SECRET_FILE или YOUTUBE_CLIENT_ID + YOUTUBE_CLIENT_SECRET.

Подключение MCP-клиента

claude mcp add --transport http youtube http://localhost:9120/mcp

Или укажите вашему MCP-шлюзу Streamable HTTP-эндпоинт.

Конфигурация

Транспорты

По умолчанию сервер использует streamable HTTP (отлично подходит для Claude Code, MetaMCP, обычного fetch). Передайте --stdio (или установите MCP_TRANSPORT=stdio), чтобы переключиться в режим stdio, который ожидают клиенты, работающие преимущественно через stdio, такие как Claude Desktop и MCP Inspector:

// claude_desktop_config.json
{
  "mcpServers": {
    "youtube": {
      "command": "npx",
      "args": ["-y", "@miller-joe/youtube-mcp", "--stdio"],
      "env": {
        "YOUTUBE_CLIENT_SECRET_FILE": "/path/to/client_secret.json",
        "YOUTUBE_TOKEN_FILE": "/path/to/token.json"
      }
    }
  }
}

Режим Stdio пропускает предварительную проверку OAuth-токена — сервер запускается даже без сохраненного токена и выдает ошибки авторизации во время вызова инструмента. Запустите youtube-mcp --auth --client-secret-file <path> один раз в режиме HTTP, чтобы сохранить токен обновления перед подключением Claude Desktop.

Инструменты

Видео

• list_my_videos: постраничный список загруженных видео на канале.

• get_video: полная информация об одном видео.

• update_video_metadata: название, описание, теги, категория, конфиденциальность.

• delete_video: безвозвратное удаление видео. Требует, чтобы confirm_video_title точно совпадал с текущим названием, в качестве защиты от случайного удаления не того видео.

Субтитры

• list_captions: список дорожек субтитров к видео (язык, название, статус, флаг черновика).

• upload_caption: загрузка дорожки субтитров в формате SRT или WebVTT к видео.

• delete_caption: удаление дорожки субтитров.

Shorts

• list_my_shorts: поиск Shorts среди недавних загрузок (фильтрация по длительности ≤60с).

• get_shorts_analytics: запрос к YouTube Analytics, ограниченный только Shorts (creatorContentType==SHORTS).

Плейлисты

• create_playlist: создание плейлиста (по умолчанию приватного).

• add_to_playlist: добавление видео в существующий плейлист.

Комментарии

• list_comments: ветки комментариев верхнего уровня к видео.

• reply_to_comment: ответ на комментарий верхнего уровня.

• moderate_comment: удержание, одобрение или отклонение комментария.

Аналитика

• query_channel_analytics: метрики за выбранный период с опциональными измерениями и фильтрами.

Мост (когда настроен COMFYUI_URL)

• generate_and_set_thumbnail: генерация превью через ComfyUI и установка его для видео одним вызовом.

Примечания по квотам

Бесплатный уровень YouTube Data API = 10 000 единиц в день. Стоимость ключевых операций:

• videos.list, commentThreads.list: 1 единица каждая.

• videos.update, comments.insert, thumbnails.set: 50 единиц каждая.

• videos.insert (загрузка): 1 600 единиц, то есть около 6 загрузок в день на бесплатном уровне.

Большинство рабочих процессов создателей контента остаются значительно ниже этого лимита.

Архитектура

┌────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│  MCP client    │────▶│  youtube-mcp     │────▶│  YouTube APIs   │
│  (Claude etc.) │◀────│  (this server)   │◀────│  (Data/Analytics)│
└────────────────┘     └────────┬─────────┘     └─────────────────┘
                                │
                                │ (bridge tools only)
                                ▼
                       ┌──────────────────┐
                       │  ComfyUI         │
                       │  (txt2img)       │
                       └──────────────────┘

Токены обновления OAuth кэшируются локально и обновляются непосредственно перед истечением срока действия. Инструмент моста загружает байты изображения из ComfyUI внутренне, поэтому ComfyUI не обязательно должен быть доступен извне.

Разработка

git clone https://github.com/miller-joe/youtube-mcp
cd youtube-mcp
npm install
npm run dev
npm run build
npm test

Требуется Node 20+.

Дорожная карта

Реализовано:

• Видео: список, получение, обновление метаданных, удаление с подтверждением названия.

• Субтитры: загрузка, список, удаление.

• Shorts: list_my_shorts (фильтр по длительности) и get_shorts_analytics (creatorContentType==SHORTS).

• Плейлисты: создание, добавление.

• Комментарии: список, ответ, модерация.

• Аналитика: запрос аналитики канала.

• Мост превью ComfyUI: generate_and_set_thumbnail.

Запланировано:

• Загрузка видео (video_upload) с поддержкой возобновляемой загрузки.

• Reporting API для массового экспорта исторических данных.

Лицензия

MIT © Joe Miller

Поддержка

Если это экономит ваше время, рассмотрите возможность поддержки разработки: