Сервер Spotify MCP

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

Функции

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

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

Название инструмента	Описание
`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 перезагрузится, вам придется снова задать учетные данные.

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Позволяет Клоду взаимодействовать со Spotify, осуществляя поиск песен, создавая плейлисты, получая рекомендации и управляя музыкой через учетную запись Spotify.

Related MCP Servers

Spotify MCP Server
varunneal
A
security
F
license
A
quality
A 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 Server
jamiew
A
security
F
license
A
quality
Connects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.
Last updated -
8
1
Python
Spotify MCP Server
boristopalov
-
security
F
license
-
quality
Connects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.
Last updated -
Python
Spotify MCP Server
Naunau75
-
security
F
license
-
quality
Connects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.
Last updated -
Python

View all related MCP servers

Spotify MCP Server