Servidor MCP de Spotify

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

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:

Asegúrate de que uv esté actualizado. Recomiendo la versión >=0.54 .
Asegúrese de que Claude tenga permisos de ejecución para el proyecto: chmod -R 755 .
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:

Sincronizar dependencias y actualizar el archivo de bloqueo:

uv sync

Distribuciones de paquetes de compilación:

uv build

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

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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Conecta a Claude con Spotify, lo que permite a los usuarios controlar la reproducción, buscar música, obtener información sobre la pista/artista y administrar la cola a través de la API de Spotify.

Related MCP Servers

Spotify MCP Server
varunneal
A
security
F
license
A
quality
A server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.
Last updated -
4
273
Python
Spotify MCP Server
jamiew
A
security
F
license
A
quality
Connects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.
Last updated -
8
1
Python
Spotify MCP Server
boristopalov
-
security
F
license
-
quality
Connects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.
Last updated -
Python
Spotify MCP Server
Naunau75
-
security
F
license
-
quality
Connects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.
Last updated -
Python

View all related MCP servers

Spotify MCP Server