Spotify MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) liviano que permite a los asistentes de IA como Cursor y Claude controlar la reproducción de Spotify y administrar listas de reproducción.

• Ejemplos de interacciones
• Herramientas
  • Operaciones de lectura
  • Jugar/Crear operaciones
• Configuración
  • Prerrequisitos
  • Instalación
  • Creación de una aplicación para desarrolladores de Spotify
  • Configuración de la API de Spotify
  • Proceso de autenticación
• Integración con Claude Desktop y Cursor

Ejemplos de interacciones

• "Toca la primera canción de Elvis"
• Crea una lista de reproducción que fusione Taylor Swift y Slipknot.
• Copiar todas las pistas tecno de mi lista de reproducción de entrenamiento a mi lista de reproducción del trabajo.

Herramientas

Operaciones de lectura

1. buscarSpotify
   • Descripción : Busca pistas, álbumes, artistas o listas de reproducción en Spotify
   • Parámetros :
     • query (cadena): el término de búsqueda
     • type (cadena): tipo de elemento a buscar (pista, álbum, artista, lista de reproducción)
     • limit (número, opcional): Número máximo de resultados a devolver (10-50)
   • Devoluciones : Lista de artículos coincidentes con sus identificaciones, nombres y detalles adicionales
   • Ejemplo : searchSpotify("bohemian rhapsody", "track", 20)
2. obtenerAhoraReproduciendo
   • Descripción : Obtenga información sobre la pista que se está reproduciendo actualmente en Spotify
   • Parámetros : Ninguno
   • Devuelve : Objeto que contiene el nombre de la pista, el artista, el álbum, el progreso de la reproducción, la duración y el estado de la reproducción.
   • Ejemplo : getNowPlaying()
3. obtenerMisListasDeReproducción
   • Descripción : Obtenga una lista de las listas de reproducción del usuario actual en Spotify
   • Parámetros :
     • limit (número, opcional): número máximo de listas de reproducción a devolver (predeterminado: 20)
     • offset (número, opcional): índice de la primera lista de reproducción que se devolverá (predeterminado: 0)
   • Devuelve : Matriz de listas de reproducción con sus identificaciones, nombres, cantidad de pistas y estado público
   • Ejemplo : getMyPlaylists(10, 0)
4. obtenerPlaylistTracks
   • Descripción : Obtenga una lista de pistas en una lista de reproducción específica de Spotify
   • Parámetros :
     • playlistId (cadena): el ID de Spotify de la lista de reproducción
     • limit (número, opcional): número máximo de pistas a devolver (predeterminado: 100)
     • offset (número, opcional): índice de la primera pista a devolver (predeterminado: 0)
   • Devuelve : Matriz de pistas con sus identificaciones, nombres, artistas, álbum, duración y fecha de adición
   • Ejemplo : getPlaylistTracks("37i9dQZEVXcJZyENOWUFo7")

Jugar/Crear operaciones

1. Reproducir música
   • Descripción : Comienza a reproducir una pista, un álbum, un artista o una lista de reproducción en Spotify
   • Parámetros :
     • uri (cadena, opcional): URI de Spotify del elemento a reproducir (anula el tipo y la identificación)
     • type (cadena, opcional): tipo de elemento a reproducir (pista, álbum, artista, lista de reproducción)
     • id (cadena, opcional): ID de Spotify del elemento a reproducir
     • deviceId (cadena, opcional): ID del dispositivo en el que se reproducirá
   • Devoluciones : Estado de éxito
   • Ejemplo : playMusic({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
   • Alternativa : playMusic({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })
2. pausaReproducción
   • Descripción : Pausa la pista que se está reproduciendo actualmente en Spotify
   • Parámetros :
     • deviceId (cadena, opcional): ID del dispositivo que se pausará
   • Devoluciones : Estado de éxito
   • Ejemplo : pausePlayback()
3. Saltar al siguiente
   • Descripción : Salta a la siguiente pista en la cola de reproducción actual
   • Parámetros :
     • deviceId (cadena, opcional): ID del dispositivo
   • Devoluciones : Estado de éxito
   • Ejemplo : skipToNext()
4. Saltar al anterior
   • Descripción : Salta a la pista anterior en la cola de reproducción actual
   • Parámetros :
     • deviceId (cadena, opcional): ID del dispositivo
   • Devoluciones : Estado de éxito
   • Ejemplo : skipToPrevious()
5. crear lista de reproducción
   • Descripción : Crea una nueva lista de reproducción en Spotify
   • Parámetros :
     • name (cadena): nombre para la nueva lista de reproducción
     • description (cadena, opcional): Descripción de la lista de reproducción
     • public (booleano, opcional): si la lista de reproducción debe ser pública (valor predeterminado: falso)
   • Devuelve : Objeto con el ID y la URL de la nueva lista de reproducción
   • Ejemplo : createPlaylist({ name: "Workout Mix", description: "Songs to get pumped up", public: false })
6. añadir pistas a la lista de reproducción
   • Descripción : Agregar pistas a una lista de reproducción de Spotify existente
   • Parámetros :
     • playlistId (cadena): ID de la lista de reproducción
     • trackUris (matriz): Matriz de URI o ID de pistas para agregar
     • position (número, opcional): Posición para insertar pistas
   • Devuelve : Estado de éxito e ID de instantánea
   • Ejemplo : addTracksToPlaylist({ playlistId: "3cEYpjA9oz9GiPac4AsH4n", trackUris: ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh"] })
7. añadir a la cola
   • Descripción : Agrega una pista, álbum, artista o lista de reproducción a la cola de reproducción actual
   • • Parámetros :
     • uri (cadena, opcional): URI de Spotify del elemento que se agregará a la cola (anula el tipo y la identificación)
     • type (cadena, opcional): tipo de elemento a poner en cola (pista, álbum, artista, lista de reproducción)
     • id (cadena, opcional): ID de Spotify del elemento que se pondrá en cola
     • deviceId (cadena, opcional): ID del dispositivo en el que se pondrá en cola
   • Devoluciones : Estado de éxito
   • Ejemplo : addToQueue({ uri: "spotify:track:6rqhFgbbKwnb9MLmUQDhG6" })
   • Alternativa : addToQueue({ type: "track", id: "6rqhFgbbKwnb9MLmUQDhG6" })

Configuración

Prerrequisitos

• Node.js v16+
• Una cuenta de Spotify Premium
• Una aplicación de desarrollador de Spotify registrada

Instalación

Creación de una aplicación para desarrolladores de Spotify

1. Vaya al panel de desarrolladores de Spotify
2. Inicia sesión con tu cuenta de Spotify
3. Haga clic en el botón "Crear una aplicación"
4. Complete el nombre y la descripción de la aplicación.
5. Acepte los Términos de Servicio y haga clic en "Crear".
6. En el panel de tu nueva aplicación, verás tu ID de cliente
7. Haga clic en "Mostrar secreto de cliente" para revelar su secreto de cliente.
8. Haga clic en "Editar configuración" y agregue una URI de redireccionamiento (por ejemplo, http://localhost:8888/callback )
9. Guarda tus cambios

Configuración de la API de Spotify

Crea un archivo spotify-config.json en la raíz del proyecto (puedes copiar y modificar el ejemplo proporcionado):

Luego edita el archivo con tus credenciales:

Proceso de autenticación

La API de Spotify utiliza OAuth 2.0 para la autenticación. Sigue estos pasos para autenticar tu aplicación:

1. Ejecute el script de autenticación:

2. El script generará una URL de autorización. Ábrala en su navegador web.
3. Se le pedirá que inicie sesión en Spotify y autorice su aplicación.
4. Después de la autorización, Spotify lo redireccionará a la URI de redireccionamiento especificada con un parámetro de código en la URL.
5. El script de autenticación intercambiará automáticamente este código por tokens de acceso y actualización.
6. Estos tokens se guardarán en su archivo spotify-config.json , que ahora se verá así:

7. El servidor actualizará automáticamente el token de acceso cuando sea necesario, utilizando el token de actualización.

Integración con Claude Desktop y Cursor

Para utilizar su servidor MCP con Claude Desktop, agréguelo a su configuración de Claude:

Para el cursor, vaya a la pestaña MCP en Cursor Settings (Comando + Mayús + J). Agregue un servidor con este comando: