MCP Яндекс Музыки для разбора вкуса

Yandex Music MCP

Однофайловый MCP-сервер Яндекс Музыки без установки через uv: лайки, плейлисты, поиск и разбор музыкального вкуса

maxecho/yandex-music-mcpАвтор:Yaroslav Lashch

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/maxecho-yandex-music-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

Выполните в терминале

claude mcp add --transport stdio --env 'YANDEX_MUSIC_TOKEN=<ваш YANDEX_MUSIC_TOKEN>' yandex-music -- uvx run /path/to/yandex_music_mcp.py

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"yandex-music","type":"stdio","command":"uvx","args":["run","/path/to/yandex_music_mcp.py"],"env":{"YANDEX_MUSIC_TOKEN":"<ваш YANDEX_MUSIC_TOKEN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "yandex-music": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add yandex-music --env 'YANDEX_MUSIC_TOKEN=<ваш YANDEX_MUSIC_TOKEN>' -- uvx run /path/to/yandex_music_mcp.py

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.yandex-music]
command = "uvx"
args = ["run", "/path/to/yandex_music_mcp.py"]
env = { YANDEX_MUSIC_TOKEN = "<ваш YANDEX_MUSIC_TOKEN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'YANDEX_MUSIC_TOKEN=<ваш YANDEX_MUSIC_TOKEN>' yandex-music uvx run /path/to/yandex_music_mcp.py

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "yandex-music": {
      "type": "local",
      "command": [
        "uvx",
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "environment": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-music": {
      "command": "uvx",
      "args": [
        "run",
        "/path/to/yandex_music_mcp.py"
      ],
      "env": {
        "YANDEX_MUSIC_TOKEN": "<ваш YANDEX_MUSIC_TOKEN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_MUSIC_TOKENсекрет, обязательная: Yandex Music API token

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 1ca416b.

Текст для агента

Установи uv, получи токен расширением Yandex Music Token, добавь сервер в claude_desktop_config.json командой uv run /путь/к/yandex_music_mcp.py с переменной YANDEX_MUSIC_TOKEN, перезапусти Claude Desktop полностью.

Другие способы из описания автора

{
  "mcpServers": {
    "yandex-music": {
      "command": "/Users/YOU/.local/bin/uv",
      "args": ["run", "/path/to/yandex_music_mcp.py"],
      "env": { "YANDEX_MUSIC_TOKEN": "your_token_here" }
    }
  }
}

Фрагмент для claude_desktop_config.json из README.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер состоит из одного Python-файла с зависимостями по PEP 723, uv сам ставит их при первом запуске, отдельной установки не нужно. Инструменты: проверка подключения и статуса Плюс, постраничное чтение лайкнутых треков, список плейлистов и их треков, поиск по каталогу, создание плейлиста, добавление и удаление треков, лайк треков. README предлагает готовый сценарий: агент читает несколько страниц лайков, берет короткое интервью о вкусе и сценариях прослушивания и собирает под это персональные плейлисты.

Для кого. Для тех, кто хочет быстро подключить Яндекс Музыку к Claude без сборки из исходников и получить разбор своего вкуса.

Подходит, если

Нужна установка одной строкой без клонирования и сборки: только uv и токен
Нужен готовый сценарий разбора вкуса и создания плейлистов под сценарии жизни
Работает не только с Claude Code и Desktop, но и с любым MCP-клиентом

Не подходит, если

Нужен анализ жанров или фильтр инструментальных треков: этого тут нет, только базовые операции
Нужно реальное воспроизведение звука: сервер только читает и меняет данные, не играет музыку

Пример запроса к агенту

Проанализируй мои лайки, что я вообще слушаю, и собери плейлист на дорогу домой на 40 минут

Ограничения

Использует приватный API Яндекс Музыки через библиотеку MarshalX/yandex-music-api, официального публичного API нет. Первый запуск занимает 30-60 секунд, пока uv разрешает зависимости. Токен можно потерять при смене пароля или отзыве сессии, тогда нужно перевыпустить его заново.

Как отключить. Удалите блок yandex-music из mcpServers в конфигурации клиента.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения
Переменные окружения
YANDEX_MUSIC_TOKEN обязательная, секрет	Токен Яндекс Музыки, проще всего получить расширением Yandex Music Token

Проверка безопасности

Токен дает полный доступ к музыкальному профилю аккаунта
Создает, наполняет и удаляет треки из плейлистов пользователя

Коротко о README

README показывает быстрый старт через uv без сборки, получение токена расширением Chrome, подключение к Claude Desktop и Claude Code, таблицу из 9 инструментов, готовый промпт для разбора вкуса и создания плейлистов под сценарии дня, раздел troubleshooting и короткую версию на русском в конце.

Частые вопросы

Нужна ли сборка проекта?

Нет, это один Python-файл с зависимостями по PEP 723, uv устанавливает их сам при первом запуске.

Как получить токен проще всего?

Расширением Chrome Yandex Music Token: войти на music.yandex.ru под нужным аккаунтом и скопировать токен из иконки расширения.

HyperFrames

Выбор редакции

Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды

СкиллСредний риск53,9 тыс.

Blender MCP

MCP for Blender

Выбор редакции

MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender

MCP-серверВысокий риск29,5 тыс.

Скиллы Remotion

Remotion Agent Skills

Выбор редакции

Официальные скиллы Remotion для создания видео на React: композиции, анимации, субтитры, карты и рендер

СкиллНизкий риск4,8 тыс.

OpenMontage

Агентная видеостудия для Claude Code, Cursor и Codex: сценарий, озвучка, картинки, стоковые кадры, музыка, субтитры и рендер

ВоркфлоуСредний риск61,8 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

HyperFrames

Blender MCP

Скиллы Remotion

OpenMontage