Сервер Spotify MCP

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

Функции

• Поиск треков на Spotify

• Просмотр вашего профиля Spotify

• Создавайте плейлисты

• Добавить треки в плейлисты

• Получайте персонализированные музыкальные рекомендации

Related MCP server: Spotify MCP Server

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

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

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

• Node.js v16 или выше

• нпм

• Аккаунт Spotify

• Зарегистрированное приложение Spotify Developer

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

1. Перейти к панели инструментов разработчика Spotify

2. Войдите в систему, используя свою учетную запись Spotify.

3. Нажмите «Создать приложение».

4. Введите название и описание приложения.

5. Добавьте http://localhost:8888/callback в качестве URI перенаправления

6. Запишите свой идентификатор клиента и секретный код клиента.

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

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

1. Откройте URL в вашем браузере.

2. Предложить вам войти в Spotify

3. Запросите разрешение на доступ к вашей учетной записи.

4. Сохраните токены в 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:

1. Посмотрите файл secrets.json , чтобы получить свои учетные данные.

2. Используйте инструмент set-spotify-credentials для аутентификации

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