MCP-сервер Яндекс Музыки с локальным плеером для macOS
yandex-music-mcp
MCP-сервер Яндекс Музыки без браузера: агент собирает плейлист, локальный демон играет его через mpv с Now Playing в Control Center
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Токен дает полный доступ к музыкальному профилю аккаунта и хранится в файле локально
- Сервер не аутентифицирован и рассчитан только на локальный запуск агентом
Установка
Ручная установка
git clone https://github.com/aramvr/yandex-music-mcp.git && cd yandex-music-mcp && pnpm install && pnpm build && node dist/cli.js authСборка из исходников, требует mpv (brew install mpv) и Xcode command line tools для нативного плеера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер превращает Яндекс Музыку в набор инструментов, которые агент вызывает напрямую: поиск, постановка в очередь, воспроизведение, управление плейлистами. Звук идет из динамиков Mac через отдельный локальный демон-плеер на mpv (или afplay как fallback), который сам проигрывает очередь без повторных вызовов агента. На macOS собирается нативное приложение на Swift: настоящая запись Now Playing в Control Center и отдельное окно с очередью и лайком/дизлайком по каждому треку. Качество звука по умолчанию лучшее доступное аккаунту, пытается взять FLAC и падает на MP3 320 CBR, настоящий lossless-эндпоинт защищен подписью и шифрованием и сознательно не реализован, чтобы не обходить защиту контента.
Для кого. Для разработчиков на macOS с подпиской Яндекс Плюс, которые хотят слушать музыку через агента без браузера и вкладок.
Подходит, если
- Нужно воспроизведение музыки прямо на Mac, а не только управление данными
- Важно, чтобы агент ставил в очередь целый сет одной командой, а не по треку
- Нужна честная работа с Now Playing в Control Center на macOS
Не подходит, если
- Не macOS: воспроизведение и нативный интерфейс работают только там, хотя поиск и плейлисты платформонезависимы
- Нужен lossless-звук: проект принципиально не обходит защиту lossless-эндпоинта, только MP3 320
- Нет подписки Яндекс Плюс: без нее API отдает только 30-секундные превью
Пример запроса к агенту
Собери и запусти сет из треков Rammstein, System of a Down и Muse на часОграничения
Используется приватный API Яндекс Музыки, официальной публичной альтернативы нет, endpoints могут поменяться без предупреждения. Нет установщика и Docker-образа, только сборка из исходников через pnpm. Воспроизведение и нативный интерфейс работают только на macOS, поиск и данные платформонезависимы. MCP-сервер не аутентифицирован и рассчитан на запуск локальным агентом, README прямо предупреждает не выставлять его наружу.
Как отключить. Выполните ym uninstall-agent, если ставили автозапуск демона, и удалите сервер из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| YM_QUALITY | lossless (по умолчанию) или high, влияет на выбор качества потока |
Проверка безопасности
- Токен дает полный доступ к музыкальному профилю аккаунта и хранится в файле локально
- Сервер не аутентифицирован и рассчитан только на локальный запуск агентом
Коротко о README
README подробно объясняет архитектуру (MCP-сервер плюс отдельный долгоживущий демон плюс нативное macOS-приложение), причины отказа от Docker и установщика, процесс входа через вставку токена вручную, настройки качества звука и то, почему lossless не реализован. Дан полный список инструментов и CLI-команд, wire-протокол демона и приложения и раздел caveats про нестабильность приватного API.
Частые вопросы
Можно ли слушать в lossless?
Проект сознательно не обходит подпись и шифрование настоящего lossless-эндпоинта, в реальности воспроизводится MP3 320 CBR.
Требуется ли пароль от аккаунта?
Нет, авторизация через собственную страницу Яндекса в браузере, в код попадает только токен, вставленный вручную.
Похожие
Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды
Blender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
Скиллы Remotion
Remotion Agent Skills
Официальные скиллы Remotion для создания видео на React: композиции, анимации, субтитры, карты и рендер
Агентная видеостудия для Claude Code, Cursor и Codex: сценарий, озвучка, картинки, стоковые кадры, музыка, субтитры и рендер