MCP-сервер spotify-mcp

Проект MCP для подключения Claude к Spotify. Построен поверх API от spotipy-dev.

[Заметка от марта 2026]: Неактивный проект. Большинство PR не будет сливаться.

Возможности

• Начать, приостановить и переключать воспроизведение
• Искать треки/альбомы/исполнителей/плейлисты
• Получать информацию о треке/альбоме/исполнителе/плейлисте
• Управлять очередью в Spotify
• Управлять, создавать и обновлять плейлисты

Демо

Видео -- включите звук

https://github.com/user-attachments/assets/20ee1f92-f3e3-4dfa-b945-ca57bc1e0894

Конфигурация

Получение API-ключей Spotify

Создайте аккаунт на developer.spotify.com. Перейдите на панель управления. Создайте приложение с redirect_uri как http://127.0.0.1:8080/callback. Вы можете выбрать любой порт, но должны использовать http и явный адрес петлевой сети (IPv4 или IPv6).

Более подробную информацию/устранение неполадок см. здесь. Вам, возможно, придется перезапустить среду MCP (например, Claude Desktop) один или два раза, прежде чем все заработает.

Поиск конфигурации MCP

Для Cursor, Claude Desktop или любого другого MCP-клиента вам придется найти свой конфиг.

• Расположение Claude Desktop на MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

• Расположение Claude Desktop на Windows: %APPDATA%/Claude/claude_desktop_config.json

Запуск проекта с помощью uvx

Добавьте этот фрагмент в вашу конфигурацию MCP.

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": [
        "--python", "3.12",
        "--from", "git+https://github.com/varunneal/spotify-mcp",
        "spotify-mcp"
      ],
      "env": {
        "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
        "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
        "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
      }
    }
  }
}

Локальный запуск проекта

Использование UVX будет открывать перенаправление Spotify для каждого вызова инструмента. Чтобы избежать этого, вы можете запустить этот проект локально, клонировав этот репозиторий:

git clone https://github.com/varunneal/spotify-mcp.git

Добавьте его в вашу конфигурацию MCP следующим образом:

json "spotify": { "command": "uv", "args": [ "--directory", "/path/to/spotify-mcp", "run", "spotify-mcp" ], "env": { "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID, "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET, "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback" } }

Устранение неполадок

Пожалуйста, создайте проблему (issue), если не можете заставить этот MCP работать. Вот несколько советов:

1. Убедитесь, что uv обновлен. Рекомендую версию >=0.54.
2. Если клонируете локально, включите права на выполнение для проекта: chmod -R 755.
3. Убедитесь, что у вас есть Spotify Premium (необходим для работы API разработчика).

Этот MCP будет выводить журналы в стандартный вывод ошибок (как указано в спецификации MCP). На Mac приложение Claude Desktop должно выводить эти журналы в ~/Library/Logs/Claude. На других платформах вы можете найти журналы здесь.

Вы можете запустить Инспектор MCP через npm с помощью этой команды:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify-mcp run spotify-mcp

После запуска Инспектор покажет URL-адрес, который вы можете открыть в браузере для начала отладки.

СПИСОК ДЕЛ

К сожалению, множество крутых функций теперь устарели в API Spotify. Большинство новых функций будут относительно незначительными или связаны с жизненным циклом проекта:

• тесты.
• ~~добавление API-поддержки для управления плейлистами.~~
• добавление API-поддержки для постраничных результатов поиска/плейлистов/альбомов.

Приветствуются PR! Спасибо @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj, @JJGO и другим за вклад.