spotify-mcp MCP-сервер

Проект MCP для подключения Клода к Spotify. Создан на основе API spotipy-dev .

Функции

• Запуск, пауза и пропуск воспроизведения

• Поиск треков/альбомов/исполнителей/плейлистов

• Получить информацию о треке/альбоме/исполнителе/плейлисте

• Управляйте очередью Spotify

• Управляйте, создавайте и обновляйте плейлисты

Related MCP server: Spotify MCP Server

Демо

Обязательно включите звук.

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

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

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

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

Запустите этот проект локально

Этот проект еще не настроен для эфемерных сред (например, использование uvx ). Запустите этот проект локально, клонировав этот репозиторий

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

Добавьте этот инструмент в качестве сервера mcp.

Claude Desktop на MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Рабочий стол Клода в Windows: %APPDATA%/Claude/claude_desktop_config.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"
    }
  }

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

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

1. Убедитесь, что uv обновлен. Я рекомендую версию >=0.54 .

2. Убедитесь, что у Клода есть разрешения на выполнение проекта: chmod -R 755 .

3. Убедитесь, что у вас есть премиум-подписка Spotify (необходима для запуска API разработчика).

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

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

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

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

ДЕЛО

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

• тесты.

• добавление поддержки API для управления плейлистами.

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

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

Развертывание

(все дела)

Строительство и издательское дело

Чтобы подготовить пакет к распространению:

1. Синхронизируем зависимости и обновляем файл блокировки:

uv sync

2. Сборка дистрибутивов пакетов:

uv build

Это создаст исходный код и дистрибутивы wheel в каталоге dist/ .

3. Опубликовать в PyPI:

uv publish

Примечание: вам необходимо задать учетные данные PyPI с помощью переменных среды или флагов команд:

• Токен: --token или UV_PUBLISH_TOKEN

• Или имя пользователя/пароль: --username / UV_PUBLISH_USERNAME и --password / UV_PUBLISH_PASSWORD