Сервер Spotify MCP

Простой сервер Model Context Protocol (MCP), который позволяет вам взаимодействовать со Spotify через Claude. Этот сервер позволяет Claude искать песни, создавать плейлисты, получать рекомендации и многое другое, используя ваш аккаунт Spotify.

Функции

Поиск треков на Spotify
Просмотр вашего профиля Spotify
Создавайте плейлисты
Добавить треки в плейлисты
Получайте персонализированные музыкальные рекомендации

Related MCP server: Spotify MCP Server

Доступные инструменты

Название инструмента	Описание
`set-spotify-credentials`	Установите учетные данные для аутентификации Spotify
`check-credentials-status`	Проверьте, верны ли ваши учетные данные и кто вошел в систему
`search-tracks`	Поиск треков по названию, исполнителю или ключевым словам
`get-current-user`	Получите информацию о своем профиле Spotify
`create-playlist`	Создайте новый плейлист в своей учетной записи
`add-tracks-to-playlist`	Добавить треки в существующий плейлист
`get-recommendations`	Получайте рекомендации на основе семенных треков

Инструкции по установке

1. Предпосылки

Node.js v16 или выше
нпм
Аккаунт Spotify
Зарегистрированное приложение Spotify Developer

2. Создайте приложение для разработчиков Spotify

Перейти к панели инструментов разработчика Spotify
Войдите в систему, используя свою учетную запись Spotify.
Нажмите «Создать приложение».
Введите название и описание приложения.
Добавьте http://localhost:8888/callback в качестве URI перенаправления
Запишите свой идентификатор клиента и секретный код клиента.

3. Установить проект

# Clone or download the project first cd spotify-mcp-server # Install dependencies npm install

4. Получите токены Spotify

Отредактируйте файл spotify-auth.js , включив в него свой идентификатор клиента и секретный ключ клиента:

// Replace these with your Spotify app credentials const CLIENT_ID = "your_client_id_here"; const CLIENT_SECRET = "your_client_secret_here";

Затем запустите скрипт аутентификации:

node spotify-auth.js

Это позволит:

Откройте URL в вашем браузере.
Предложить вам войти в Spotify
Запросите разрешение на доступ к вашей учетной записи.
Сохраните токены в secrets.json

5. Создайте сервер MCP

npm run build

6. Настройте рабочий стол Claude

Отредактируйте файл конфигурации Claude Desktop:

В macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
В Windows: %APPDATA%\Claude\claude_desktop_config.json

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

{ "mcpServers": { "spotify": { "command": "node", "args": ["/full/path/to/spotify-mcp-server/build/spotify-mcp-server.js"] } } }

Замените /full/path/to/spotify-mcp-server на фактический путь к каталогу вашего проекта.

7. Перезагрузите Claude Desktop.

Закройте и снова откройте Claude Desktop, чтобы загрузить новую конфигурацию.

Использование

Когда вы начнете разговор с Клодом, вам сначала нужно будет указать свои учетные данные Spotify:

Посмотрите файл secrets.json , чтобы получить свои учетные данные.
Используйте инструмент set-spotify-credentials для аутентификации
Затем используйте любой другой инструмент Spotify.

Примеры подсказок

Настройка учетных данных

I want to connect to my Spotify account. Here are my credentials from secrets.json: Tool: set-spotify-credentials Parameters: { "clientId": "your_client_id", "clientSecret": "your_client_secret", "accessToken": "your_access_token", "refreshToken": "your_refresh_token" }

Основные команды

Проверьте свой аккаунт:

Can you check who I'm logged in as on Spotify? Tool: get-current-user Parameters: {}

Поиск треков:

Search for songs by Weekend Tool: search-tracks Parameters: { "query": "Taylor Swift", "limit": 5 }

Создать плейлист:

Create a new playlist called "My Pretty pretty girlfriend" Tool: create-playlist Parameters: { "name": "My Pretty pretty girlfriend", "description": "For my girlfriend. Created with Claude and the Spotify MCP server" }

Многошаговые задачи

Создание плейлиста с песнями:

I want to create a workout playlist with energetic songs. First, search for some high-energy songs. Then create a playlist called "Workout Mix" and add those songs to it.

Получение рекомендаций на основе избранного:

I like the song "Blinding Lights" by The Weeknd. Can you search for it, then find similar songs, and create a playlist with those recommendations?

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

Ошибка: нет доступного токена доступа : сначала вам необходимо задать свои учетные данные с помощью инструмента set-spotify-credentials
Ошибки аутентификации : Ваши токены могли устареть. Запустите скрипт аутентификации еще раз, чтобы получить свежие токены
Неверные учетные данные : дважды проверьте, что вы используете правильный идентификатор клиента и секретный ключ клиента.

Примечания

Сервер хранит учетные данные только в памяти.
Вам нужно будет вводить учетные данные каждый раз, когда вы начинаете новый разговор.
Если Claude Desktop перезагрузится, вам придется снова задать учетные данные.

One-click Deploy

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Spotify MCP Server