local-only server

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

Integrations

Allows control of Spotify playback including play, pause, skip functions, search for tracks/albums/artists/playlists, get information about Spotify content, and manage the Spotify queue

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

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!

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.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Un servidor que conecta a Claude con Spotify, permitiendo a los usuarios controlar la reproducción, buscar contenido, obtener información sobre pistas/álbumes/artistas/listas de reproducción y administrar la cola de Spotify.

Related Resources

Reddit Discussion about this server

Spotify MCP Server