Skip to main content
Glama
Spotify MCP Server

Spotify MCP Server

by g2dgaming

Servidor MCP de spotify-mcp

Proyecto MCP para conectar a Claude con Spotify. Desarrollado con la API de spotipy-dev .

Características

  • Iniciar, pausar y omitir la reproducción

  • Buscar pistas/álbumes/artistas/listas de reproducción

  • Obtener información sobre una pista/álbum/artista/lista de reproducción

  • Administrar la cola de Spotify

  • Administrar, crear y actualizar listas de reproducción

Related MCP server: Spotify MCP Server

Manifestación

Asegúrese de activar el audio

Configuración

Obtener claves API de Spotify

Crea una cuenta en developer.spotify.com . Ve al panel de control . Crea una aplicación con el redirect_uri http://127.0.0.1:8080/callback . Puedes elegir el puerto que quieras, pero debes usar http y una dirección de bucle invertido explícita (IPv4 o IPv6).

Consulte aquí para obtener más información y solución de problemas. Es posible que tenga que reiniciar su entorno MCP (por ejemplo, Claude Desktop) una o dos veces para que funcione.

Ejecutar este proyecto localmente

Este proyecto aún no está configurado para entornos efímeros (p. ej., uso de uvx ). Ejecútelo localmente clonando este repositorio.

git clone https://github.com/varunneal/spotify-mcp.git

Agregue esta herramienta como servidor mcp.

Escritorio de Claude en MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Escritorio de Claude en Windows: %APPDATA%/Claude/claude_desktop_config.json

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify_mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
    }
  }

Solución de problemas

Si no consigues que este MCP funcione, abre un problema. Aquí tienes algunos consejos:

  1. Asegúrate de que uv esté actualizado. Recomiendo la versión >=0.54 .

  2. Asegúrese de que Claude tenga permisos de ejecución para el proyecto: chmod -R 755 .

  3. Asegúrate de tener Spotify Premium (necesario para ejecutar la API para desarrolladores).

Este MCP emitirá registros a std err (según lo especificado en la especificación del MCP). En Mac, la aplicación Claude Desktop debería emitir estos registros a ~/Library/Logs/Claude . En otras plataformas, puede encontrar los registros aquí .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

HACER

Lamentablemente, varias funciones interesantes de la API de Spotify han quedado obsoletas . La mayoría de las nuevas funciones serán relativamente menores o afectarán la salud del proyecto:

  • pruebas.

  • agregando soporte API para administrar listas de reproducción.

  • agregando soporte API para resultados de búsqueda paginados/listas de reproducción/álbumes.

¡Se agradecen las relaciones públicas! Gracias a @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj y otros por sus contribuciones.

Despliegue

(hacer)

Construcción y publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync
  1. Distribuciones de paquetes de compilación:

uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

  1. Publicar en PyPI:

uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

  • Token: --token o UV_PUBLISH_TOKEN

  • O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Available Tools

5 tools
SpotifyGetInfoA

Get detailed information about a Spotify item (track, album, artist, or playlist).

Inputs: item_uri (required).

SpotifyPlaybackB

Manages the current playback with the following actions: - get: Get information about user's current track. - start: Starts playing new item or resumes current playback if called with no uri. - pause: Pauses current playback. - skip: Skips current track.

Inputs: action (required), num_skips, spotify_uri.

SpotifyPlaylistC

Manage Spotify playlists. - get: Get a list of user's playlists. - get_tracks: Get tracks in a specific playlist. - add_tracks: Add tracks to a specific playlist. - remove_tracks: Remove tracks from a specific playlist. - change_details: Change details of a specific playlist.

Inputs: action (required), description, name, playlist_id, +1 more.

SpotifyQueueB

Manage the playback queue - get the queue or add tracks.

Inputs: action (required), track_id.

SpotifySearchB

Search for tracks, albums, artists, or playlists on Spotify.

Inputs: query (required), limit, qtype.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: SpotifyGetInfo retrieves metadata, SpotifyPlayback handles real-time playback control, SpotifyPlaylist manages playlist content and details, SpotifyQueue manages the playback queue, and SpotifySearch performs searches. There is no overlap in functionality that would cause confusion.

    Naming Consistency5/5

    All tool names follow a consistent 'Spotify' prefix with a descriptive noun or verb-noun pattern (e.g., SpotifyGetInfo, SpotifyPlayback, SpotifyPlaylist, SpotifyQueue, SpotifySearch). This uniformity makes the tool set predictable and easy to navigate.

    Tool Count5/5

    With 5 tools, the server is well-scoped for managing Spotify interactions, covering key areas like playback, playlists, search, queue, and general info. Each tool earns its place without feeling bloated or insufficient for the domain.

    Completeness4/5

    The tool set provides comprehensive coverage for core Spotify operations, including CRUD for playlists, playback control, search, and queue management. A minor gap is the lack of user profile or library management tools (e.g., managing saved tracks or albums), but agents can still handle most common workflows effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers