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.

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 .env :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 MCPAsegúrese de reiniciar su cliente MCP (Cursor/Claude) para aplicar la configuración.

Ejecución del servidor