Spotify MCP Server
MCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
- 490 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Токены доступа и обновления Spotify лежат в файле spotify-config.json вместе с Client Secret
- Агент может создавать и менять плейлисты, удалять любимые треки и менять воспроизведение на ваших устройствах
- Запрашивает 15 областей доступа Spotify, включая данные профиля и подписки
Установка
- Работает в
Ручная установка
git clone https://github.com/marcelmarais/spotify-mcp-server.git && cd spotify-mcp-server && npm ci && npm run buildНужны Node.js Current, аккаунт Premium и приложение в Spotify Developer Dashboard. Затем создайте spotify-config.json по примеру и выполните npm run auth.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токены доступа и обновления Spotify лежат в файле spotify-config.json вместе с Client Secret
- Агент может создавать и менять плейлисты, удалять любимые треки и менять воспроизведение на ваших устройствах
- Запрашивает 15 областей доступа Spotify, включая данные профиля и подписки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер отдает агенту 28 инструментов Spotify. Чтение: поиск треков, альбомов, исполнителей и плейлистов, текущий трек с устройством и громкостью, очередь, последние прослушивания, любимые треки, подписки на исполнителей и список устройств Spotify Connect. Управление: запуск трека, альбома, исполнителя или плейлиста, пауза и продолжение, переключение, добавление в очередь, абсолютная и относительная громкость. Для плейлистов есть создание, переименование, добавление, удаление и перестановка треков. Для альбомов агент получает данные и треки, сохраняет их в медиатеку и проверяет, сохранены ли они. Любимые треки удаляются по ID, до 40 за запрос, из плейлиста до 100. По умолчанию сервер работает по stdio и хранит токены в spotify-config.json, обновляя их сам. Режим MCP_TRANSPORT=http запускает один процесс для нескольких клиентов по адресу 127.0.0.1:3000/mcp. С MCP_AUTH=spotify он принимает токен Spotify в заголовке запроса и ничего не пишет на диск.
Для кого. Для тех, кто слушает Spotify с Premium и хочет управлять музыкой и плейлистами фразами в Claude Desktop, Cursor или Cline.
Подходит, если
- Нужно собрать плейлист по описанию, например смесь двух исполнителей, и добавить в него найденные треки
- Требуется перенести треки одного плейлиста в другой, например техно из тренировочного в рабочий
- Хочется менять громкость и очередь фразами через агента: «сделай потише», «поставь следующим этот альбом»
- Нужно узнать, что играет сейчас и на каком устройстве, и перенести воспроизведение на другое
- Один сервер должен обслуживать несколько клиентов, тогда запускайте его в режиме Streamable HTTP
Не подходит, если
- У вас нет Spotify Premium: громкость и часть управления воспроизведением его требуют
- Нужна работа с чужими аккаунтами: сервер использует вашу авторизацию и ваши плейлисты
- Вы не готовы регистрировать приложение в Spotify Developer Dashboard и хранить Client Secret
- Агенту нельзя давать право удалять любимые треки и менять плейлисты, а ограничить набор инструментов вы не можете
Пример запроса к агенту
Создай плейлист «Смесь Taylor Swift и Slipknot» и добавь туда по пять самых известных треков каждого исполнителяMCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
MCP_TRANSPORT- Значение http включает Streamable HTTP вместо stdio
MCP_HTTP_PORT- Порт HTTP-режима, по умолчанию 3000
MCP_AUTH- Значение spotify включает проверку токена Spotify в заголовке запроса
Ограничения
- Нужны аккаунт Spotify Premium и зарегистрированное приложение в Spotify Developer Dashboard с Client ID, Client Secret и Redirect URI.
- Для сборки нужна последняя версия Node.js из линейки Current, старые линейки README не поддерживает.
- Установка из исходников: клонирование, npm ci и npm run build, пакета для запуска через npx в README нет.
- Сервис Spotify и его доступность из России в репозитории не описаны.
Как отключить. Удалите блок spotify из конфигурации MCP-клиента и остановите процесс сервера. Токены лежат в spotify-config.json в папке проекта, удалите файл, а доступ приложения можно отозвать в настройках аккаунта Spotify.
Частые вопросы
Как подключить Spotify к Claude Desktop через MCP?
Соберите сервер (npm ci, npm run build), создайте приложение в Spotify Developer Dashboard и пройдите npm run auth. Затем добавьте в claude_desktop_config.json блок spotify с command node и путем к build/index.js, как показано в README, и перезапустите Claude Desktop.
Нужен ли Spotify Premium для MCP-сервера?
Для установки громкости и ее изменения Premium нужен, об этом сказано в описании инструментов setVolume и adjustVolume. В списке требований README он указан как условие работы целиком.
Что умеет агент с плейлистами через этот сервер?
Создавать плейлист, менять название, описание и видимость, добавлять и удалять треки, переставлять диапазон треков и читать содержимое. Для безопасной правки удалению и перестановке можно передать snapshotId нужной версии плейлиста.
Как запустить сервер для нескольких клиентов сразу?
Задайте MCP_TRANSPORT=http и порт MCP_HTTP_PORT, клиенты подключатся к http://127.0.0.1:3000/mcp. С MCP_AUTH=spotify сервер работает как OAuth-защищенный `endpoint`, а в репозитории есть Dockerfile и docker-compose.yml для такого режима.
Где Spotify MCP хранит токены?
В файле spotify-config.json в корне проекта. Сервер сам обновляет токен доступа, обычно раз в час. Если обновление не удалось, повторите npm run auth. В режиме MCP_AUTH=spotify токены на диск не пишутся.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыPython-библиотека и MCP-сервер, которые отдают агенту открытые данные Spotify, тексты песен и транскрипты без ключа API
MCP-сервер Яндекс Музыки с локальным плеером для macOS
yandex-music-mcp
MCP-сервер Яндекс Музыки без браузера: агент собирает плейлист, локальный демон играет его через mpv с Now Playing в Control Center
MCP-сервер Яндекс Музыки с анализом жанров
Yandex Music MCP Server
Неофициальный MCP-сервер Яндекс Музыки: лайки, жанровый анализ, поиск и управление плейлистами по HTTP или stdio
MCP-сервер для Ableton Live: агент создает дорожки, расставляет клипы и собирает аранжировку прямо в открытом проекте
MCP Music Forge: загрузка и обработка треков
MCP Music Forge
MCP-сервер с очередью на Redis: скачивает треки с SoundCloud, YouTube, Яндекс Музыки и Spotify, конвертирует и проставляет теги с обложкой
MCP Яндекс Музыки для разбора вкуса
Yandex Music MCP
Однофайловый MCP-сервер Яндекс Музыки без установки через uv: лайки, плейлисты, поиск и разбор музыкального вкуса
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Spotify MCP Server (эта запись) | нет | OAuth | 490 | |
| MCP-сервер плеера Яндекс Музыки aurlune | нет | API-ключ | 0 | MCP для локального плеера Яндекс Музыки на Linux: другой сервис и другая платформа |
| SpotifyScraper | нет | не нужна | 322 | python-библиотека и MCP-сервер |
Коротко о README
README начинается с четырех примеров запросов и списка из 28 инструментов, разбитых на чтение, управление воспроизведением и создание, альбомы и плейлисты. Затем идут требования, установка из исходников, регистрация приложения Spotify и процедура OAuth с автоматическим обновлением токена. Последние разделы описывают подключение к Claude Desktop, Cursor и Cline, режим Streamable HTTP, OAuth для MCPHub и запуск в Docker.