MCP-сервер Яндекс Музыки с локальным плеером для macOS
yandex-music-mcp
MCP-сервер Яндекс Музыки без браузера: агент собирает плейлист, локальный демон играет его через mpv с Now Playing в Control Center
- 1 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Токен дает полный доступ к музыкальному профилю аккаунта и хранится в файле локально
- Сервер не аутентифицирован и рассчитан только на локальный запуск агентом
Установка
- Работает в
- Сервисы
Ручная установка
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 на часMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
YM_QUALITY- lossless (по умолчанию) или high, влияет на выбор качества потока
Ограничения
Используется приватный API Яндекс Музыки, официальной публичной альтернативы нет, endpoints могут поменяться без предупреждения. Нет установщика и Docker-образа, только сборка из исходников через pnpm. Воспроизведение и нативный интерфейс работают только на macOS, поиск и данные платформонезависимы. MCP-сервер не аутентифицирован и рассчитан на запуск локальным агентом, README прямо предупреждает не выставлять его наружу.
Как отключить. Выполните ym uninstall-agent, если ставили автозапуск демона, и удалите сервер из конфигурации MCP клиента.
Частые вопросы
Можно ли слушать в lossless?
Проект сознательно не обходит подпись и шифрование настоящего lossless-эндпоинта, в реальности воспроизводится MP3 320 CBR.
Требуется ли пароль от аккаунта?
Нет, авторизация через собственную страницу Яндекса в браузере, в код попадает только токен, вставленный вручную.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер Яндекс Музыки с анализом жанров
Yandex Music MCP Server
Неофициальный MCP-сервер Яндекс Музыки: лайки, жанровый анализ, поиск и управление плейлистами по HTTP или stdio
MCP-сервер к локальному плееру и демону синхронизации Яндекс Музыки на Rust для Linux: управление плеером, вкус, подборки под настроение
MCP-сервер создания плейлистов Яндекс Музыки
Yandex Music MCP Server (unofficial)
Минималистичный MCP-сервер для создания плейлистов в Яндекс Музыке: поиск треков и добавление их в плейлист
MCP Яндекс Музыки для разбора вкуса
Yandex Music MCP
Однофайловый MCP-сервер Яндекс Музыки без установки через uv: лайки, плейлисты, поиск и разбор музыкального вкуса
MCP Music Forge: загрузка и обработка треков
MCP Music Forge
MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой
applemusic-mcp — Apple Music через Claude и Cursor
applemusic-mcp
MCP-сервер управляет плейлистами, библиотекой, каталогом, воспроизведением и очередью Apple Music, уровень доступа задаете вы
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP-сервер Яндекс Музыки с локальным плеером для macOS (эта карточка) | нет | не нужна | 1 | |
| MCP-сервер Яндекс Музыки с анализом жанров | нет | API-ключ | 2 | с жанровым анализом и плейлистами |
| MCP Яндекс Музыки для разбора вкуса | нет | API-ключ | 0 | разбор вкуса без установки |
Коротко о README
README подробно объясняет архитектуру (MCP-сервер плюс отдельный долгоживущий демон плюс нативное macOS-приложение), причины отказа от Docker и установщика, процесс входа через вставку токена вручную, настройки качества звука и то, почему lossless не реализован. Дан полный список инструментов и CLI-команд, wire-протокол демона и приложения и раздел caveats про нестабильность приватного API.