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

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://localhost:8888 . (Puedes elegir el puerto que quieras, pero debes usar http y localhost). Establecí "APIs usadas" en "Web Playback SDK".

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.

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json 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://localhost:8888"
    }
  }

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).

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.

Despliegue

(hacer)

Instalación mediante herrería

Para instalar Spotify-MCP para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @varunneal/spotify-mcp --client claude

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

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

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

npx @modelcontextprotocol/inspector uv --directory /Users/varun/Documents/Python/spotify_mcp run spotify-mcp

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

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

Conecta a Claude con Spotify, lo que permite a los usuarios controlar la reproducción, buscar contenido, obtener información musical y administrar la cola de Spotify.

Related MCP Servers

Spotify MCP Server
varunneal
A
security
A
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
350
Python
MIT License
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
Spotify MCP Server
g2dgaming
A
security
F
license
A
quality
Connects Claude with Spotify, allowing users to control playback, search for music, get track/artist information, and manage the queue via the Spotify API.
Last updated -
5
Python

View all related MCP servers

Spotify MCP Server