MCP Music Forge: загрузка и обработка треков
MCP Music Forge
MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Скачивает контент с внешних музыкальных площадок, использование регулируется их условиями
- Хранит токен аккаунта Яндекс Музыки с подпиской, доступ к нему дает доступ к личному аккаунту
Установка
Ручная установка
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 с обложкойОграничения
Загрузка музыки с этих площадок регулируется их условиями использования, проект прямо пишет, что уважает 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 клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_MUSIC_TOKEN секрет | Токен аккаунта Яндекс Музыки с подпиской Плюс для скачивания полных треков |
| YANDEX_MUSIC_API_PROXY | Прокси с российским адресом для доступа к api.music.yandex.net из-за рубежа |
| REDIS_URL обязательная | Адрес Redis для очереди задач |
Проверка безопасности
- Скачивает контент с внешних музыкальных площадок, использование регулируется их условиями
- Хранит токен аккаунта Яндекс Музыки с подпиской, доступ к нему дает доступ к личному аккаунту
Коротко о README
README описывает сервис как масштабируемый MCP-плагин для скачивания и обработки аудио с SoundCloud, YouTube, Яндекс Музыки и Spotify: транскодирование, теги, обложки, HTTP API, MCP-инструменты и воркеры на очереди. Показаны два варианта запуска, Docker Compose и локально через uv, три MCP-инструмента (probe_url, enqueue_download, get_job_status) и структура проекта по слоям: сервер, провайдеры, транскодер, хранилище, очередь. В разделе Legal Notes отдельно подчеркнуто, что провайдер SoundCloud качает только помеченные как downloadable треки.
Частые вопросы
Почему трек из Яндекс Музыки получается коротким?
Без токена аккаунта с подпиской Плюс API Яндекса отдает только 30-секундный отрывок, и джоба на полный трек отклоняется.
Нужен ли прокси?
Да, если сервер работает не из России: api.music.yandex.net отвечает ошибкой 451 из других стран.
Похожие
Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды
Blender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
Скиллы Remotion
Remotion Agent Skills
Официальные скиллы Remotion для создания видео на React: композиции, анимации, субтитры, карты и рендер
Агентная видеостудия для Claude Code, Cursor и Codex: сценарий, озвучка, картинки, стоковые кадры, музыка, субтитры и рендер