Сервер 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";
Затем запустите скрипт аутентификации:
Это позволит:
- Откройте URL в вашем браузере.
- Предложить вам войти в Spotify
- Запросите разрешение на доступ к вашей учетной записи.
- Сохраните токены в
secrets.json
5. Создайте сервер MCP
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 перезагрузится, вам придется снова задать учетные данные.