Spotify MCP Server

Interactúa con la API de Spotify para gestionar listas de reproducción y controlar la reproducción de música.

GitHub
1
Prueba este MCPPatrocinado

Documentación

title: Spotify MCP Server emoji: 🎵 colorFrom: blue colorTo: purple sdk: gradio sdk_version: 5.33.1 app_file: server.py pinned: false

Spotify MCP Server

Un servidor MCP basado en Gradio que proporciona una interfaz fácil de usar para interactuar con la API de Spotify. Este servidor ofrece varias herramientas para gestionar tu experiencia de Spotify, desde la autenticación hasta la gestión de listas de reproducción y el control de reproducción de música.

Video de demostración

Ver el video de demostración

Características

  • Autenticación: Autenticación segura de Spotify mediante OAuth2
  • Búsqueda de música: Busca pistas y obtén información de artistas
  • Gestión de cola: Añade canciones a tu cola de Spotify (requiere Spotify Premium)
  • Reproducidas recientemente: Ve tus pistas reproducidas recientemente
  • Gestión de listas de reproducción:
    • Crear nuevas listas de reproducción
    • Ver listas de reproducción existentes
    • Añadir canciones a listas de reproducción
  • Información del usuario:
    • Ver artistas principales
    • Ver pistas principales
    • Obtener información de géneros

Requisitos

  • Python 3.x
  • Cuenta de Spotify Premium (requerida para algunas funciones de gestión de cola)
  • Cuenta de desarrollador de Spotify para credenciales de API

Configuración

  1. Clona este repositorio
  2. Instala las dependencias requeridas: 
    pip install gradio spotipy

Configuración

Obtención de claves de API de Spotify

  1. Crea una cuenta en developer.spotify.com
  2. Navega al panel de control
  3. Crea una nueva aplicación con la siguiente configuración:
    • URI de redirección: http://127.0.0.1:5000/callback (puedes elegir cualquier puerto, pero debes usar http y una dirección de bucle local explícita)
    • Nota: Es posible que necesites reiniciar tu entorno MCP (por ejemplo, Claude Desktop) una o dos veces antes de que funcione

Variables de entorno

El servidor utiliza las siguientes variables de entorno: Por favor, crea un archivo .env con las credenciales

  • CLIENT_ID: Tu ID de cliente de la API de Spotify
  • CLIENT_SECRET: Tu secreto de cliente de la API de Spotify
  • REDIRECT_URI: Tu URI de redirección de la API de Spotify (por defecto: http://127.0.0.1:5000/callback)

Ejecución local

Este proyecto está diseñado para ejecutarse localmente y aún no está configurado para entornos efímeros (por ejemplo, uso de uvx). Para ejecutarlo:

  1. Clona este repositorio
  2. Configura tus variables de entorno
  3. Ejecuta el servidor

Consultas de ejemplo para Claude Desktop

Prueba estas consultas de ejemplo en Claude Desktop para explorar diferentes funciones:

Descubrimiento de música y análisis

"Muéstrame mis 10 artistas principales y sus géneros de los últimos 6 meses"

Creación inteligente de listas de reproducción

"Crea una lista de reproducción con mis 20 pistas principales de este mes"

Gestión de cola

"Busca 'I Like Me Better' y añádela a mi cola"

Organización de listas de reproducción

"Muéstrame todas mis listas de reproducción"

Curación de música

"Compara mis 10 pistas principales de este mes con mis favoritas de todos los tiempos"

Acciones rápidas

"Muéstrame mis 5 canciones reproducidas más recientemente"

Endpoints de API

El servidor expone varios endpoints a través de interfaces de Gradio:

  • add_to_queue_song: Añade una canción a la cola (requiere Premium)
  • get_artist_and_track: Busca pistas
  • auth_with_spotify: Autentícate con Spotify
  • get_recently_played_songs: Obtén pistas reproducidas recientemente
  • create_playlist: Crea una nueva lista de reproducción
  • get_playlist_name_and_id: Obtén información de la lista de reproducción
  • add_songs_to_playlist: Añade canciones a una lista de reproducción
  • get_users_top_artists: Obtén los artistas principales del usuario
  • get_user_top_tracks: Obtén las pistas principales del usuario

Funciones Premium

Las siguientes funciones requieren una cuenta de Spotify Premium:

  • Añadir canciones a la cola

Configuración de Claude Desktop

Para usar este servidor MCP con Claude Desktop, añade la siguiente configuración a tus ajustes (el número de puerto puede variar, por favor verifica):

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:7860/gradio_api/mcp/sse"]
    }
  }
}

Esta configuración permite que Claude Desktop se conecte al servidor MCP de Gradio que se ejecuta en el puerto 7860.

Tags

mcp-server-track