Servidor MCP de Spotify

Este proyecto implementa un servidor de Protocolo de Contexto de Modelo (MCP) que permite controlar la reproducción de Spotify usando lenguaje natural a través de un cliente MCP, como Cursor o Claude para Desktop (solo macOS y Windows).

Características

Este servidor expone las siguientes herramientas:

• play : reproducir una pista, un álbum o una lista de reproducción, o reanudar la reproducción.

• pause : Pausa la reproducción.

• next : Saltar a la siguiente pista.

• previous : Salta a la pista anterior.

• get_current_track : obtiene información sobre la pista que se está reproduciendo actualmente.

• search : busca pistas, álbumes, artistas o listas de reproducción.

Related MCP server: Spotify MCP Server

Prerrequisitos

• Bun (versión 1.0.0 o posterior)

• Una cuenta Spotify Premium.

• Una aplicación para desarrolladores de Spotify:

  • Crea uno en el Panel de desarrolladores de Spotify .

  • Obtenga su ID de cliente y secreto de cliente.

  • Agregue http://localhost:8888/callback a las URI de redireccionamiento en la configuración de su aplicación.

• Un cliente MCP (por ejemplo, Cursor o Claude for Desktop).

Instalación y configuración

1. Clonar el repositorio:

   git clone https://github.com/obre10off/spotify-mcp.git cd spotify-mcp

2. Instalar dependencias:

   bun install

3. Crea un archivo

   Crea un archivo llamado .env en la raíz del directorio del proyecto. Agrega lo siguiente, reemplazando los marcadores con tus credenciales de Spotify:

   SPOTIFY_CLIENT_ID=your_spotify_client_id SPOTIFY_CLIENT_SECRET=your_spotify_client_secret SPOTIFY_REDIRECT_URI=http://localhost:8888/callback # These will be filled in after running the auth script: SPOTIFY_ACCESS_TOKEN= SPOTIFY_REFRESH_TOKEN=

4. Ejecute el script de autorización:

   Este script abrirá su navegador, le solicitará que inicie sesión en Spotify y otorgue permisos, y luego recuperará su acceso inicial y sus tokens de actualización.

   bun run auth

   El script imprimirá los valores SPOTIFY_ACCESS_TOKEN y SPOTIFY_REFRESH_TOKEN en la consola. Copie estos valores en su archivo .env .

5. Configure su cliente MCP:

   • Cursor:

     • Abra la configuración del cursor (Cmd+ o Ctrl+).

     • Buscar "Protocolo de contexto de modelo".

     • Haga clic en "Editar en settings.json".

     • Agregue lo siguiente a la matriz mcp.servers (reemplace /absolute/path/to/your/spotify-mcp con la ruta absoluta a su directorio spotify-mcp ):

       { "mcp.servers": [ { "spotify": { "command": "bun", "args": ["/absolute/path/to/your/spotify-mcp/src/index.ts"], "env": { "SPOTIFY_CLIENT_ID": "your_spotify_client_id", "SPOTIFY_CLIENT_SECRET": "your_spotify_client_secret", "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback", "SPOTIFY_ACCESS_TOKEN": "your_spotify_access_token", "SPOTIFY_REFRESH_TOKEN": "your_spotify_refresh_token" } } } ] }

       Se recomienda utilizar un archivo .env y solo colocar allí las variables de entorno relacionadas con Spotify, en lugar de agregar los valores al archivo settings.json.

   • Claude para escritorio (macOS/Windows):

     • Abra el archivo de configuración de Claude for Desktop:

       • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

       • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

     • Agregue lo siguiente al objeto mcpServers (reemplace /absolute/path/to/your/spotify-mcp con la ruta absoluta a su directorio spotify-mcp ): GXP6

   • Importante: utilice siempre rutas absolutas en la configuración de su cliente.

6. Reinicie su cliente MCP

   Asegúrese de reiniciar su cliente MCP (Cursor/Claude) para aplicar la configuración.

Ejecución del servidor