kenzolika/yandex-music-mcp

Неофициальный MCP-сервер для **Яндекс Музыки**. Подключается к Claude Desktop, Claude Code и другим MCP-клиентам и даёт ассистенту доступ к вашей библиотеке: лайкам, истории прослушиваний, «Моей волне» и плейлистам.
Сервер работает локально на вашем компьютере (stdio). Токен хранится только у вас и никуда не передаётся. Поддерживаются Windows, macOS и Linux.
> ⚠️ **Неофициальный проект.** Не связан с ООО «Яндекс» и не одобрен им. Использует неофициальную библиотеку yandex-music: если Яндекс изменит API, сервер может временно перестать работать. Аудио сервер **не скачивает** — только работает с метаданными, лайками и плейлистами вашего аккаунта.
English version below ↓
---
Что умеет
| Чтение | Изменения |
|---|---|
| account_info — проверка подключения | create_playlist — новый плейлист (по умолчанию приватный) |
| search — поиск треков, альбомов, артистов и плейлистов | add_tracks_to_playlist — добавить треки |
| get_liked_tracks — «Мне нравится» | remove_tracks_from_playlist — убрать треки |
| get_listening_history — история прослушиваний по дням | delete_playlist — удалить плейлист (с проверкой названия) |
| list_my_playlists, get_playlist_tracks — ваши плейлисты | like_tracks / unlike_tracks — лайки |
| get_playlist_by_url — любой публичный плейлист или альбом по ссылке | export_tracks_to_file — выгрузка лайков или плейлиста в .txt и .csv |
| get_album_tracks, get_artist_tracks — альбомы и артисты | |
| get_similar_tracks, get_my_wave, get_chart — рекомендации и чарт | |
Воспроизведением сервер не управляет: музыку вы слушаете, как обычно, в приложении Яндекс Музыки, а новые плейлисты и лайки появляются там сразу.
Примеры запросов
- «Проанализируй мои последние 300 лайков: какие жанры и десятилетия я слушаю?»
- «Что я слушал на этой неделе?»
- «Собери приватный плейлист "Осень" из 25 треков, похожих на мои последние лайки»
- «Вот плейлист друга: . Что из него уже есть в моих лайках?»
- «Выгрузи все мои лайки в файл»
---
Быстрая установка
**1. Установите uv** — он скачает и запустит коннектор:
- Windows (PowerShell):
- macOS / Linux:
Закройте терминал, откройте заново и проверьте: uv --version.
**2. Войдите в Яндекс (один раз):**
**3. Подключите к клиенту:**
- **Claude Code** — одна команда:
- **Claude Desktop** — откройте **Settings → Developer → Edit Config** и добавьте в файл claude_desktop_config.json:
Если что-то не получилось, ниже — пошаговая установка из исходников с подробностями.
---
Установка из исходников
Понадобятся uv и аккаунт Яндекса. Для части функций (например, «Моей волны») может понадобиться подписка Плюс.
1. Установите uv
**Windows (PowerShell):**
**macOS / Linux:**
Закройте терминал, откройте заново и проверьте: uv --version.
2. Скачайте проект
Или нажмите **Code → Download ZIP** на странице репозитория и распакуйте архив.
3. Получите токен (один раз)
Откроется страница входа Яндекса (ya.ru/device), а в терминале появится код. Войдите в аккаунт, введите код и дождитесь в терминале строки «Готово!». Токен сохранится в ~/.yandex-music-mcp/token. Скрипт использует официальный вход Яндекса и вашего пароля не видит.
4. Узнайте полный путь к папке проекта
Клиенту нужно знать, где лежит проект. Самый простой способ — в терминале, в папке проекта (после шага 3 вы уже в ней):
- **Windows (PowerShell):** (Get-Location).Path → например, C:\Users\Ivan\Documents\yandex-music-mcp
- **macOS / Linux:** pwd → например, /Users/ivan/yandex-music-mcp
На Windows можно и мышкой: в Проводнике зажмите **Shift**, щёлкните по папке правой кнопкой и выберите **«Копировать как путь»**.
> **Важно для Windows:** в JSON-конфиге обратный слэш нужно удваивать: C:\\Users\\Ivan\\Documents\\yandex-music-mcp. Можно вместо этого писать прямые слэши — Windows их понимает: C:/Users/Ivan/Documents/yandex-music-mcp.
5а. Подключите к Claude Desktop
В Claude Desktop откройте **Settings → Developer → Edit Config** — откроется файл claude_desktop_config.json. Добавьте в него блок mcpServers, подставив свой путь из шага 4: