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.

Spotify MCP Server

Integrations