MCP Music Forge: загрузка и обработка треков
MCP Music Forge
MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой
- 5 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скачивает контент с внешних музыкальных площадок, использование регулируется их условиями
- Хранит токен аккаунта Яндекс Музыки с подпиской, доступ к нему дает доступ к личному аккаунту
Установка
- Работает в
- Сервисы
Ручная установка
cp .env.example .env && make upbЗапуск всего стека в Docker Compose, MCP доступен по HTTP на /mcp.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скачивает контент с внешних музыкальных площадок, использование регулируется их условиями
- Хранит токен аккаунта Яндекс Музыки с подпиской, доступ к нему дает доступ к личному аккаунту
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер принимает ссылку на трек через инструмент probe_url, определяет провайдера и проверяет, можно ли его скачать, ставит задачу в очередь на Redis через enqueue_download и отдает статус и файлы как MCP-ресурсы через get_job_status. Есть адаптеры для SoundCloud (только если трек помечен площадкой как доступный для скачивания), YouTube и Яндекс Музыки, транскодер поверх ffmpeg и проставление тегов с обложкой. Для Яндекс Музыки нужен токен аккаунта с подпиской Плюс, иначе API отдает только 30-секундный отрывок и джоба отклоняется, а для доступа к api.music.yandex.net из-за границы (Сингапур, Таиланд в тестах авторов) нужен прокси с российским адресом. Помимо MCP есть HTTP API и Telegram-бот поверх того же ядра.
Для кого. Для тех, кто хочет забрать свою же музыку из Яндекс Музыки, SoundCloud или YouTube локально через агента вместо ручного скачивания.
Подходит, если
- Нужно скачать и конвертировать трек с проставлением тегов и обложки одним запросом
- Есть подписка Яндекс Музыка Плюс и нужен полный трек, а не 30-секундный отрывок
- Нужна очередь задач с повторной доставкой файла, например в Telegram
Не подходит, если
- Нет подписки Яндекс Музыка Плюс и нужны полные треки: без токена API отдает только превью
- Нет доступа к серверу с российским IP или прокси: официальный API Яндекса блокирует запросы из-за рубежа
Пример запроса к агенту
Скачай этот трек из Яндекс Музыки и пришли готовый mp3 с обложкойMCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
YANDEX_MUSIC_TOKENсекрет- Токен аккаунта Яндекс Музыки с подпиской Плюс для скачивания полных треков
YANDEX_MUSIC_API_PROXY- Прокси с российским адресом для доступа к api.music.yandex.net из-за рубежа
REDIS_URLобязательная- Адрес Redis для очереди задач
Ограничения
Загрузка музыки с этих площадок регулируется их условиями использования, проект прямо пишет, что уважает SoundCloud ToU и качает только помеченные как скачиваемые треки, но ответственность за легальность использования на других площадках лежит на пользователе. Нужны Redis, ffmpeg и Python-окружение через uv или Docker Compose, готового облачного хостинга нет. Для YouTube нужны файлы cookie и, возможно, сторонний сервис PO-токенов, для Яндекс Музыки токен аккаунта с Плюс-подпиской и прокси с российским IP для доступа к API из-за рубежа.
Как отключить. Остановите стек командой make down (Docker Compose) или завершите процесс python -m mcp_music_forge.mcp_app и удалите сервер из конфигурации MCP клиента.
Частые вопросы
Почему трек из Яндекс Музыки получается коротким?
Без токена аккаунта с подпиской Плюс API Яндекса отдает только 30-секундный отрывок, и джоба на полный трек отклоняется.
Нужен ли прокси?
Да, если сервер работает не из России: api.music.yandex.net отвечает ошибкой 451 из других стран.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер Яндекс Музыки с анализом жанров
Yandex Music MCP Server
Неофициальный MCP-сервер Яндекс Музыки: лайки, жанровый анализ, поиск и управление плейлистами по HTTP или stdio
MCP-сервер создания плейлистов Яндекс Музыки
Yandex Music MCP Server (unofficial)
Минималистичный MCP-сервер для создания плейлистов в Яндекс Музыке: поиск треков и добавление их в плейлист
MCP Яндекс Музыки для разбора вкуса
Yandex Music MCP
Однофайловый MCP-сервер Яндекс Музыки без установки через uv: лайки, плейлисты, поиск и разбор музыкального вкуса
MCP-сервер Яндекс Музыки с локальным плеером для macOS
yandex-music-mcp
MCP-сервер Яндекс Музыки без браузера: агент собирает плейлист, локальный демон играет его через mpv с Now Playing в Control Center
MCP-сервер к локальному плееру и демону синхронизации Яндекс Музыки на Rust для Linux: управление плеером, вкус, подборки под настроение
MCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP Music Forge: загрузка и обработка треков (эта карточка) | нет | ключ необязателен | 5 | |
| SpotifyScraper | нет | не нужна | 325 | python-библиотека и MCP-сервер |
| Audio Studio MCP | да | не нужна | 657 | Локальный MCP-сервер создает музыку и звуковые эффекты, собирает петли, выравнивает громкость и сохраняет звук для игры или видео. |
Коротко о README
README описывает сервис как масштабируемый MCP-плагин для скачивания и обработки аудио с SoundCloud, YouTube, Яндекс Музыки и Spotify: транскодирование, теги, обложки, HTTP API, MCP-инструменты и воркеры на очереди. Показаны два варианта запуска, Docker Compose и локально через uv, три MCP-инструмента (probe_url, enqueue_download, get_job_status) и структура проекта по слоям: сервер, провайдеры, транскодер, хранилище, очередь. В разделе Legal Notes отдельно подчеркнуто, что провайдер SoundCloud качает только помеченные как downloadable треки.