MCP yt-dlp Server

Сервер Model Context Protocol (MCP) для загрузки видео и потоков с помощью yt-dlp. Этот сервер позволяет MCP-совместимым клиентам (например, Claude Desktop) загружать видео с YouTube и более чем 1000 поддерживаемых сайтов, извлекать аудио, загружать субтитры и захватывать живые трансляции.

Благодарности

Этот проект основан на невероятной работе команды yt-dlp. yt-dlp — это многофункциональный загрузчик аудио/видео из командной строки, поддерживающий тысячи сайтов. Для получения дополнительной информации о yt-dlp посетите их репозиторий GitHub или вики.

Related MCP server: MCP YouTube Downloader

Возможности

• Загрузка видео: Загрузка видео с YouTube и более чем 1000 поддерживаемых сайтов

• Загрузка потоков: Захват живых трансляций и потоков HLS/m3u8

• Информация о видео: Получение метаданных без загрузки

• Список форматов: Список всех доступных форматов для видео

• Поиск: Поиск видео напрямую через экстракторы yt-dlp

• Извлечение аудио: Загрузка только аудио с конвертацией формата (MP3, M4A, WAV, FLAC)

• Субтитры: Загрузка субтитров на нескольких языках

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

Предварительные требования

• Node.js 18+

• yt-dlp установлен и доступен в той же директории, что и сервер (или в PATH)

Руководство по установке

Шаг 1: Установка Node.js

Загрузите и установите Node.js 18+ с nodejs.org.

Проверьте установку:

node --version
npm --version

Шаг 2: Загрузка yt-dlp (простой способ)

Мы предоставляем скрипты установки, которые автоматически загружают последнюю версию yt-dlp в правильную директорию.

Windows: Дважды щелкните setup.bat или выполните в командной строке:

setup.bat

Linux / macOS:

chmod +x setup.sh
./setup.sh

Скрипт выполнит следующее:

• Определит вашу операционную систему

• Загрузит последний бинарный файл yt-dlp

• Поместит его в ту же директорию, что и MCP-сервер

• Проверит установку

Шаг 2 (альтернатива): Ручная загрузка

Если вы предпочитаете установить yt-dlp вручную:

Windows:

1. Загрузите yt-dlp.exe из последних релизов

2. Поместите yt-dlp.exe в ту же директорию, что и MCP-сервер

macOS:

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
chmod a+rx /usr/local/bin/yt-dlp

Linux:

sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

Python (все платформы):

pip install yt-dlp

Дополнительные варианты установки см. в руководстве по установке yt-dlp.

Шаг 3: Клонирование репозитория

git clone https://github.com/timyee22/yt-dlp-MCP.git
cd yt-dlp-MCP

Шаг 4: Установка зависимостей

npm install

Шаг 5: Настройка MCP-клиента

Добавьте сервер в конфигурацию вашего MCP-клиента:

Claude Desktop (Windows): Отредактируйте %APPDATA%\Claude\settings.json:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["C:\\path\\to\\yt-dlp-MCP\\index.js"]
    }
  }
}

Claude Desktop (macOS/Linux): Отредактируйте ~/Library/Application Support/Claude/settings.json (macOS) или соответствующий путь конфигурации:

{
  "mcpServers": {
    "yt-dlp": {
      "command": "node",
      "args": ["/path/to/yt-dlp-MCP/index.js"]
    }
  }
}

Важно: Убедитесь, что yt-dlp.exe (Windows) или yt-dlp (macOS/Linux) находится либо:

• В той же директории, что и index.js

• Или доступен в системном PATH

Шаг 6: Перезапустите Claude Desktop

После добавления конфигурации перезапустите Claude Desktop, чтобы загрузить новый MCP-сервер.

Использование

После настройки вы можете попросить Claude:

• "Загрузите это видео с YouTube: [URL]"

• "Загрузите только аудио из этого видео в формате MP3"

• "Получите информацию об этом видео без его загрузки"

• "Перечислите все доступные форматы для этого видео"

• "Найдите видео по теме [тема] на YouTube"

• "Загрузите субтитры для этого видео на испанском языке"

Доступные инструменты

download_video

Загружает видео по URL-адресам.

Параметры:

• url (обязательно): URL видео

• outputDir: Выходная директория (по умолчанию: текущая директория)

• format: Выбор формата (по умолчанию: "best")

• quality: Качество видео (например, "1080p", "720p")

• audioOnly: Загружать только аудио (по умолчанию: false)

• audioFormat: Формат аудио для извлечения (по умолчанию: "mp3")

• subtitles: Загружать субтитры (по умолчанию: false)

• subtitleLangs: Языки субтитров (по умолчанию: "en")

• playlistStart/playlistEnd: Диапазон плейлиста

• noPlaylist: Загружать только одно видео (по умолчанию: false)

• additionalArgs: Дополнительные аргументы yt-dlp

Примеры:

Загрузить видео с YouTube:

{
  "url": "https://www.youtube.com/watch?v=...",
  "quality": "1080p",
  "subtitles": true
}

Загрузить только аудио:

{
  "url": "https://www.youtube.com/watch?v=...",
  "audioOnly": true,
  "audioFormat": "mp3"
}

download_stream

Загружает живые трансляции или HLS-потоки.

Параметры:

• url (обязательно): URL потока

• outputDir: Выходная директория

• duration: Продолжительность захвата в секундах

• format: Предпочтение формата (по умолчанию: "best")

• outputName: Пользовательское имя выходного файла

• hlsUseMpegts: Использовать MPEG-TS для HLS (по умолчанию: true)

• additionalArgs: Дополнительные аргументы

get_video_info

Получает метаданные видео без загрузки.

Параметры:

• url (обязательно): URL видео

• flatPlaylist: Более быстрая информация о плейлисте (по умолчанию: false)

list_formats

Перечисляет все доступные форматы для URL.

Параметры:

• url (обязательно): URL видео

search_videos

Ищет видео с помощью экстракторов yt-dlp.

Параметры:

• query (обязательно): Поисковый запрос

• extractor: Префикс поискового экстрактора (по умолчанию: "ytsearch10")

• getInfo: Получить подробную информацию (по умолчанию: true)

Пример:

{
  "query": "programming tutorials",
  "extractor": "ytsearch5"
}

update_yt_dlp

Обновляет yt-dlp до последней версии.

Поддерживаемые сайты

yt-dlp поддерживает более 1000 сайтов, включая:

• YouTube

• Twitch

• Vimeo

• Twitter/X

• Instagram

• TikTok

• Facebook

• SoundCloud

• И многие другие...

Полный список см. в поддерживаемых сайтах yt-dlp.

Устранение неполадок

yt-dlp не найден

• Убедитесь, что yt-dlp.exe (Windows) или yt-dlp (macOS/Linux) находится в той же директории, что и сервер, или в вашем PATH

• В Windows вам может потребоваться добавить директорию в переменную среды PATH

Ошибки Node.js

• Убедитесь, что у вас установлен Node.js 18+: node --version

• Убедитесь, что зависимости установлены: npm install

Формат недоступен

• Некоторые видео могут не иметь запрошенного формата. Используйте list_formats, чтобы увидеть доступные варианты

• YouTube может ограничивать некоторые форматы. Попробуйте другие настройки качества

Лицензия

Unlicense

Благодарности

• yt-dlp — мощный загрузчик видео, который делает это возможным

• Model Context Protocol — протокол, позволяющий ИИ-ассистентам использовать инструменты