A
securityF
licenseA
qualityA server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.
Last updated -
4
273
Python
spotify-mcp MCP-сервер
Проект MCP для подключения Клода к Spotify. Создан на основе API spotipy-dev .
Функции
- Запуск, пауза и пропуск воспроизведения
- Поиск треков/альбомов/исполнителей/плейлистов
- Получить информацию о треке/альбоме/исполнителе/плейлисте
- Управляйте очередью Spotify
- Управляйте, создавайте и обновляйте плейлисты
Демо
Обязательно включите звук.
Конфигурация
Получение ключей API Spotify
Создайте учетную запись на developer.spotify.com . Перейдите на панель управления . Создайте приложение с redirect_uri как http://127.0.0.1:8080/callback . Вы можете выбрать любой порт, но вы должны использовать http и явный адрес обратной связи (IPv4 или IPv6).
См. здесь для получения дополнительной информации/устранения неполадок. Возможно, вам придется перезапустить среду MCP (например, Claude Desktop) один или два раза, прежде чем все заработает.
Запустите этот проект локально
Этот проект еще не настроен для эфемерных сред (например, использование uvx ). Запустите этот проект локально, клонировав этот репозиторий
Добавьте этот инструмент в качестве сервера mcp.
Claude Desktop на MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Рабочий стол Клода в Windows: %APPDATA%/Claude/claude_desktop_config.json
Поиск неисправностей
Пожалуйста, откройте проблему, если вы не можете заставить этот MCP работать. Вот несколько советов:
- Убедитесь, что
uvобновлен. Я рекомендую версию>=0.54. - Убедитесь, что у Клода есть разрешения на выполнение проекта:
chmod -R 755. - Убедитесь, что у вас есть премиум-подписка Spotify (необходима для запуска API разработчика).
Этот MCP будет выдавать логи в std err (как указано в спецификации MCP). На Mac приложение Claude Desktop должно выдавать эти логи в ~/Library/Logs/Claude . На других платформах вы можете найти логи здесь .
Вы можете запустить MCP Inspector через npm с помощью этой команды:
После запуска Инспектор отобразит URL-адрес, к которому вы можете перейти в своем браузере, чтобы начать отладку.
ДЕЛО
К сожалению, куча крутых функций теперь устарела из Spotify API. Большинство новых функций будут относительно незначительными или для здоровья проекта:
- тесты.
- добавление поддержки API для управления плейлистами.
- добавление поддержки API для постраничных результатов поиска/плейлистов/альбомов.
Пиар приветствуется! Спасибо @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj и другим за вклад.
Развертывание
(все дела)
Строительство и издательское дело
Чтобы подготовить пакет к распространению:
- Синхронизируем зависимости и обновляем файл блокировки:
- Сборка дистрибутивов пакетов:
Это создаст исходный код и дистрибутивы wheel в каталоге dist/ .
- Опубликовать в PyPI:
Примечание: вам необходимо задать учетные данные PyPI с помощью переменных среды или флагов команд:
- Токен:
--tokenилиUV_PUBLISH_TOKEN - Или имя пользователя/пароль:
--username/UV_PUBLISH_USERNAMEи--password/UV_PUBLISH_PASSWORD
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Подключает Claude к Spotify, позволяя пользователям управлять воспроизведением, искать музыку, получать информацию о треке/исполнителе и управлять очередью через API Spotify.
Related MCP Servers
- AsecurityFlicenseAqualityConnects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.Last updated -81Python
- -securityFlicense-qualityConnects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.Last updated -Python
- -securityFlicense-qualityConnects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.Last updated -Python