Что агент делает с вашей музыкой
Серверы отличаются набором действий. Одни только читают библиотеку, другие меняют плейлисты, третьи управляют плеером на компьютере.
- Разбирает вкус. MCP Яндекс Музыки для разбора вкуса читает лайки постранично, берет у вас короткое интервью и собирает персональные плейлисты. Сервер умещается в один Python-файл. uv ставит зависимости при первом запуске за 30–60 секунд.
- Считает жанры. MCP-сервер Яндекс Музыки с анализом жанров фильтрует лайки по жанру, периоду и explicit-метке и держит их в кэше 5 минут.
- Собирает плейлист по запросу. MCP-сервер создания плейлистов умеет 3 действия: создать плейлист, найти треки и добавить их.
- Играет музыку на Mac. MCP-сервер с локальным плеером для macOS отдает очередь демону на mpv и показывает трек в Now Playing в Control Center.
- Управляет плеером на Linux. aurlune работает с плеером через mpv и MPRIS в KDE и не трогает музыку, которую включил не он. Лайк он ставит только по прямой просьбе.
- Скачивает треки. MCP Music Forge ставит загрузку в очередь Redis, конвертирует файл через ffmpeg и проставляет теги. Для Яндекс Музыки нужна подписка Плюс. Без нее API отдает 30-секундный отрывок.
Как получить токен Яндекс Музыки
Серверы работают с токеном вашего аккаунта. Отдельного ключа API у Яндекс Музыки нет. Большинство из них опирается на библиотеку yandex-music-api, и токен получают по ее инструкциям. В сервер создания плейлистов встроена команда получения токена через device flow с client_id мобильного приложения Яндекс Музыки, и автор прямо пишет, что это нарушает условия использования. Другие способы автор тоже предлагает на ваш риск.
Токен хранят локально. aurlune читает его из файла ~/.config/ym/token с правами 0600. После смены пароля или отзыва сессии токен перестает работать, и его выпускают заново.
Сервер для разбора вкуса добавляет npx skillfoxx add mcp/maxecho-yandex-music-mcp, и CLI заранее покажет, в какой файл настроек агента он запишется.
Какой сервер выбрать
У aurlune минимальный доступ, у остальных серверов расширенный. Все работают без VPN, кроме Music Forge, для которого это не проверено.
- Хотите разбор вкуса без сборки — сервер для разбора вкуса, который запускает uv.
- Нужна статистика по жанрам и HTTP-режим — сервер с анализом жанров и опциональным секретом аутентификации.
- Слушаете на macOS — сервер с локальным плеером. Его собирают из исходников через pnpm.
- Слушаете на Linux с KDE Plasma — aurlune. Он проверен на Arch Linux и Wayland и собирается через cargo build.
- Нужны другие сервисы Яндекса — Карты, Диск и Алиса разобраны в разделе российский стек.
Условия сервиса и риски
Условия использования Яндекс Музыки разрешают пользоваться сервисом только в личных некоммерческих целях, а копировать и распространять материалы без согласования с Яндексом запрещают. Music Forge описывает загрузку как способ забрать свою музыку. Ответственность за использование файлов лежит на пользователе.
Приватный API может измениться без предупреждения, и тогда серверы перестанут работать до обновления. Сервер с плеером для macOS не аутентифицирован, и README прямо предупреждает не выставлять его наружу. Плейлисты агент меняет в вашем аккаунте. Первые запросы давайте на тестовом плейлисте.