YouTube Studio & Channel Analytics MCP Server

Сервер Model Context Protocol (MCP) промышленного уровня для YouTube Studio и интеллектуальной аналитики канала

Расширяйте возможности ИИ-ассистентов (Claude, Cursor, Antigravity и др.) для анализа вашего YouTube-канала, отслеживания метрик видео, глубокого погружения в аналитику YouTube Studio, определения источников трафика аудитории и анализа тональности сообщества — полностью настраивается через файл .env.

🚀 Возможности и набор MCP-инструментов

YouTube Studio MCP предоставляет 8 специализированных инструментов:

Related MCP server: YouTube MCP Server

⚙️ Конфигурация окружения (.env)

Все учётные данные и настройки считываются непосредственно из файла .env:

# Google OAuth 2.0 Credentials (from Google Cloud Console)
YOUTUBE_CLIENT_ID=your_client_id.apps.googleusercontent.com
YOUTUBE_CLIENT_SECRET=your_client_secret

# OAuth Refresh Token (written automatically by run_auth.py)
YOUTUBE_REFRESH_TOKEN=

🛠️ Пошаговое руководство по настройке

1. Клонирование и установка зависимостей с помощью uv

git clone https://github.com/Dhananjayrbiraris/youtube-mcp.git
cd youtube-mcp

uv venv
uv pip install -e .

2. Создание проекта Google Cloud (однократно)

1. Откройте Google Cloud Console.

2. Создайте новый проект (например, YouTube-Studio-MCP).

3. В APIs & Services > Library включите:

   • YouTube Data API v3

   • YouTube Analytics API

4. В OAuth consent screen:

   • Тип пользователя: External -> укажите имя приложения и вашу электронную почту.

   • В разделе Test users добавьте свой адрес Google.

5. В Credentials:

   • Нажмите Create Credentials > OAuth client ID.

   • Тип приложения: Desktop App.

   • Скопируйте Client ID и Client Secret.

6. Вставьте их в файл .env:

YOUTUBE_CLIENT_ID=123456789-xxxx.apps.googleusercontent.com
YOUTUBE_CLIENT_SECRET=GOCSPX-xxxx

3. Запустите аутентификатор в один клик

uv run run_auth.py

Это запустит ваш браузер для входа через Google OAuth в один клик. Он автоматически запишет YOUTUBE_REFRESH_TOKEN прямо в ваш файл .env.

4. Подключение к вашему ИИ-клиенту

Claude Desktop

Добавьте в свой claude_desktop_config.json:

{
  "mcpServers": {
    "youtube-studio": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/youtube-mcp",
        "run",
        "youtube-studio-mcp"
      ]
    }
  }
}

💡 Примеры запросов к ИИ

• "Дайте мне обзор эффективности моего YouTube-канала за последние 28 дней."

• "Откуда приходит большая часть моего трафика (поиск, рекомендованные видео или обзорные страницы)?"

• "Какое из моих видео принесло больше всего подписчиков в этом месяце?"

• "Обобщите общие темы и вопросы из комментариев к моему последнему видео."

• "Покажите разбивку моей аудитории по возрастным группам и странам."

🧪 Тестирование

Запустите набор тестов:

pytest

📄 Лицензия

Этот проект лицензирован в соответствии с MIT License.