marcelmarais/spotify-mcp-server

Spotify MCP сервер

Лёгкий сервер Model Context Protocol (MCP), который позволяет AI-ассистентам, таким как Cursor и Claude, управлять воспроизведением Spotify и управлять плейлистами.

Содержание

• Примеры взаимодействий
• Инструменты
• Операции чтения
• Операции с альбомом
• Запускать / создавать операции
• Операции с плейлистом
• Настройка
• Предварительные требования
• Установка
• Создание приложения для разработчиков Spotify
• Конфигурация API Spotify
• Процесс аутентификации
• Интеграция с Claude Desktop, Cursor и VsCode (Cline)
• Потоковый HTTP
• OAuth (MCPHub и другие клиенты с поддержкой OAuth)
• Docker (рекомендуется для MCPHub)

Примеры взаимодействий

• «Сыграйте первую песню Элвиса»
• “Создать плейлист слияния Тейлор Свифт / Slipknot”
• “Скопировать все техно-треки из моего плейлиста тренировок в рабочий плейлист”
• “Убавь громкость немного”

Инструменты

Чтение Операции

1. поиск в Spotify

• Описание: Поиск треков, альбомов, исполнителей или плейлистов на Spotify
• Параметры:
• query (строка): Поисковый запрос
• type (строка): Тип элемента для поиска (трек, альбом, исполнитель, плейлист)
• limit (число, по желанию): Максимальное количество результатов (1-10, по умолчанию: 10)

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Cursor & Claude to control Spotify playback and manage playlists.

Example Interactions

• “Play Elvis’s first song”
• “Create a Taylor Swift / Slipknot fusion playlist”
• “Copy all the techno tracks from my workout playlist to my work playlist”
• “Turn the volume down a bit”

Tools

Read Operations

1. searchSpotify

   • Description: Search for tracks, albums, artists, or playlists on Spotify
   • Parameters:
     • query (string): The search term
     • type (string): Type of item to search for (track, album, artist, playlist)
     • limit (number, optional): Maximum number of results to return (1-10, default: 10)
     • offset (number, optional): Index of the first result to return (default: 0)
   • Returns: List of matching items with their IDs, names, and additional details
   • Example: searchSpotify("bohemian rhapsody", "track", 10)

2. getNowPlaying

   • Description: Get information about the currently playing track on Spotify, including device and volume info
   • Parameters: None
   • Returns: Object containing track name, artist, album, playback progress, duration, playback state, device info, volume, and shuffle/repeat status
   • Example: getNowPlaying()

3. getMyPlaylists

   • Description: Get a list of the current user’s playlists on Spotify
   • Parameters:
     • limit (number, optional): Maximum number of playlists to return (default: 20)
     • offset (number, optional): Index of the first playlist to return (default: 0)
   • Returns: Array of playlists with their IDs, names, track counts, and public status
   • Example: getMyPlaylists(10, 0)

4. getPlaylistTracks