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

Spotify MCP Server

Integrations