Spotify

Controla la reproducción de Spotify y gestiona tus canciones favoritas usando LLMs.

Documentación

Servidor MCP de Spotify

Un servidor MCP simple para controlar la reproducción de Spotify y gestionar tus canciones favoritas mediante LLM.

Características

  • Reproducir y pausar la reproducción de Spotify
  • Obtener información sobre la pista actual
  • Añadir la pista actual a tus canciones favoritas

Configuración

  1. Clona el repositorio:

    git clone https://github.com/yourusername/spotify-mcp-server.git
    cd spotify-mcp-server
    
  2. Crea y activa un entorno virtual:

    python3 -m venv .venv
    source .venv/bin/activate
    
  3. Instala las dependencias:

    pip install uv
    pip install -r requirements.txt
    
  4. Crea un archivo .env:

    SPOTIPY_CLIENT_ID=your_spotify_client_id
    SPOTIPY_CLIENT_SECRET=your_spotify_client_secret
    SPOTIPY_REDIRECT_URI=http://localhost:8888/callback
    
  5. Ejecuta el servidor:

    python main.py
    

Integración con Claude Desktop (Servidor MCP)

Para usar este servidor como servidor MCP con Claude, añade la siguiente entrada a tu archivo de configuración de Claude (normalmente ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "spotify-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PROJECT/spotify-mcp-server",
        "run",
        "main.py"
      ]
    }
  }
}
  • Reemplaza /ABSOLUTE/PATH/TO/PROJECT/spotify-mcp-server con la ruta real a tu proyecto
  • Si el comando uv no se reconoce, proporciona la ruta absoluta del ejecutable uv (se puede encontrar con which uv en MacOS)
  • Asegúrate de que tus variables de entorno estén configuradas ya sea en la configuración o mediante un archivo .env.
  • Reinicia Claude después de editar el archivo de configuración.

Notas

Ejemplo de sesión

A continuación se muestra un ejemplo de sesión usando Claude con el servidor MCP de Spotify:

Example Conversation

Interacción de ejemplo:

User: Play the current track using Spotify MCP server
Claude: Playback started successfully

User: What song is playing?
Claude: Currently playing: Shape of You by Ed Sheeran

User: Like this song
Claude: Added 'Shape of You' to your Liked Songs.