Edutube MCP

🌐 Сайт проекта (GitHub Pages): https://engmohammeda.github.io/edutube-mcp/ — включает живой обозреватель реально извлечённых уроков.

Превращайте плейлисты и видео YouTube в структурированные уроки, анализы, кадры и тесты — с помощью Google Gemini и автоматической ротации моделей.

MCP stdio-сервер + CLI для AI-агентов и LMS-конвейеров. Вставьте URL плейлиста и получите JSON по каждому уроку: дословный диалог с арабскими переводами, ключевые выражения, словарь, культурные/произносительные примечания и тест из 10 вопросов — извлечённые из фактического аудио и визуала, а не только из субтитров.

playlist URL ──▶ Edutube ──▶ lesson-01.json … lesson-NN.json + lessons-all.json

Возможности

• Импорт плейлиста по URL — вставьте URL любого плейлиста YouTube (или id плейлиста, или URL отдельного видео). Записи разрешаются через YouTube Data API, если задан YOUTUBE_API_KEY, в противном случае автоматически через yt-dlp --flat-playlist (дополнительный ключ не нужен).

• Извлечение структурированных уроков — встроенная LMS-схема (dialogue / key_expressions / global_vocabulary / lesson_notes / quiz) с опцией пользовательской схемы для вашего собственного формата.

• Конвейер для длинных видео с оконным запасным вариантом — сначала проход по всему видео; если это не удаётся (квота, дедлайны, очень длинные VOD), автоматически переключается на извлечение 150-секундными окнами с объединением и дедупликацией.

• Автоматическая ротация моделей — у каждой модели Gemini свой пул квот бесплатного тарифа. При 429 RESOURCE_EXHAUSTED тот же запрос прозрачно повторяется на следующей доступной модели. Каталог моделей обнаруживается в реальном времени из Gemini API, поэтому новые модели (например, gemini-3.6-flash, gemini-3.7-*) попадают в ротацию без изменений кода.

• Инструменты мультимодального анализа — analyze_youtube_video (аудио + визуал), analyze_youtube_video_audio (сначала речь), точное извлечение JPEG-кадров с помощью yt-dlp + ffmpeg, метаданные через YouTube Data API.

• Длинные VOD и сессии — основанный на задачах analyze_long_youtube_video, переиспользуемые продолжения с sessionId и фоновые задания для совместимости (start_long_youtube_analysis → poll → result → cancel).

• Пакеты с безопасным возобновлением — уже валидные файлы уроков пропускаются; прерванные запуски продолжаются с места остановки.

• Режим CLI — edutube-mcp extract <url> работает без какого-либо MCP-клиента.

Related MCP server: YT-NINJA

Требования

• Node.js ≥ 20

• Ключ Google Gemini API (GEMINI_API_KEY)

• Необязательно: YOUTUBE_API_KEY (инструмент метаданных + более быстрый импорт плейлистов)

• Необязательно, но рекомендуется: yt-dlp и ffmpeg в PATH (или YT_DLP_PATH)

Быстрый старт (MCP-клиент)

{
  "mcpServers": {
    "edutube": {
      "command": "npx",
      "args": ["-y", "@engmohammeda/edutube-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_gemini_key_here",
        "YOUTUBE_API_KEY": "optional_youtube_key_here"
      }
    }
  }
}

Из исходников:

git clone https://github.com/engmohammeda/edutube-mcp.git
cd edutube-mcp
npm install && npm run build
cp .env.example .env   # fill GEMINI_API_KEY
npm start              # MCP stdio server

Быстрый старт (CLI)

# extract a whole playlist into ./edutube-output
edutube-mcp extract "https://www.youtube.com/playlist?list=PL..." --out ./edutube-output --max 20

# or a single video
edutube-mcp extract "https://www.youtube.com/watch?v=VIDEO_ID" --out ./lessons

Stdout — это чистый JSON (прогресс идёт в stderr), поэтому его можно напрямую передавать в скрипты и импортёры LMS.

Инструменты (15)

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

Интеграции с клиентами

Claude Code

claude mcp add edutube --transport stdio -- node /path/to/edutube-mcp/dist/index.js

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "edutube": {
      "command": "node",
      "args": ["/path/to/edutube-mcp/dist/index.js"],
      "env": { "GEMINI_API_KEY": "..." }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.edutube]
command = "node"
args = ["/path/to/edutube-mcp/dist/index.js"]
env = { GEMINI_API_KEY = "..." }

Документация

• Установка

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

• Инструменты

• Уроки плейлиста (конвейер Edutube)

• Ротация моделей

• CLI

• Длинные видео

• Журнал изменений

Конфиденциальность и ограничения

Медиафайлы, URL и промпты отправляются в Google Gemini. Ключи бесплатного тарифа имеют небольшие ежедневные квоты на модель (~20 запросов/день/модель); автоматическая ротация распределяет работу по всем моделям вашего ключа. Для производственных пакетов используйте платный ключ (pay-as-you-go). Приватные, возрастные, DRM- или регионально-ограниченные видео могут не обработаться. Вы несёте ответственность за соблюдение условий YouTube и Gemini.

Лицензия

MIT — см. LICENSE.

Арабский

Edutube MCP — превращает плейлисты и видео YouTube в структурированные уроки, готовые к импорту в LMS: полный диалог с арабским переводом, ключевые выражения, словарь с обязательными примерами, культурные/произносительные примечания на арабском и тест из 10 вопросов разных типов — извлечённые из фактического аудио и изображения, а не только из текстовых субтитров.

Ключевые возможности:

• Импорт плейлиста простой вставкой ссылки через инструмент start_edutube_extraction (или команду CLI edutube-mcp extract) с автоматическим возобновлением, пропускающим завершённые уроки.

• Автоматическая ротация между моделями Gemini: при исчерпании квоты любой модели (429) запрос автоматически повторяется на следующей модели, с динамическим обнаружением любых новых моделей, доступных для вашего ключа.

• Конвейер длинных видео + запасной вариант с 150-секундными окнами при сбое, с объединением и дедупликацией.

• 15 инструментов MCP, включая мультимодальный анализ, точное извлечение JPEG-кадров, метаданные и фоновые задания для клиентов с фиксированными таймаутами.

Быстрый старт: скопируйте .env.example в .env и задайте GEMINI_API_KEY, затем npm install && npm run build && npm start, или используйте CLI напрямую. См. документацию выше для подробностей и интеграции с Claude Code, Cursor и Codex.