🎵 MCP Claude Spotify [Node.js - Spotify API - Claude Desktop]

MCP Claude Spotify es una integración que permite a Claude Desktop interactuar con Spotify utilizando el Model Context Protocol (MCP). Esta potente integración facilita el control mediante IA de tu reproducción de Spotify y la gestión de tu biblioteca directamente desde la interfaz de Claude Desktop.

Demo

Características Principales:

• Autenticación Fluida con Spotify: Flujo OAuth seguro para conectar tu cuenta de Spotify
• Búsqueda Completa: Encuentra canciones, álbumes, artistas y listas de reproducción con consultas en lenguaje natural
• Control de Reproducción: Reproduce, pausa y salta canciones, todo mediante comandos conversacionales
• Gestión de Playlists: Crea listas de reproducción y añade canciones según tus preferencias
• Recomendaciones Personalizadas: Obtén sugerencias musicales curadas por IA basadas en tus hábitos de escucha

Visión Técnica:

• Backend Node.js: Gestiona la autenticación, interacciones con la API e integración con Claude Desktop
• Model Context Protocol (MCP): Permite a Claude gestionar llamadas a la API y mantener el estado entre sesiones
• Spotify Web API: Proporciona acceso a todas las funcionalidades de Spotify y datos de usuario
• Autenticación OAuth 2.0: Garantiza acceso seguro a las cuentas de usuario con los permisos adecuados
• Gestión Automática del Servidor MCP: El servidor puede iniciarse manualmente o ser lanzado automáticamente por Claude Desktop

Guía de Instalación:

# Clonar repositorio
git clone https://github.com/imprvhub/mcp-claude-spotify
cd mcp-claude-spotify

# Instalar dependencias
npm install

# Opcional: Compilar desde el código fuente
npm run build

Configuración de la API de Spotify:

1. Obtén tus credenciales de la API de Spotify en el Panel de Desarrolladores de Spotify
2. Configura una aplicación de Spotify con la URI de redirección: http://127.0.0.1:8888/callback
3. Configura el servidor MCP con tu Client ID y Secret:

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["RUTA_AL_DIRECTORIO/mcp-claude-spotify/build/index.js"],
      "env": {
        "SPOTIFY_CLIENT_ID": "tu_client_id_aquí",
        "SPOTIFY_CLIENT_SECRET": "tu_client_secret_aquí"
      }
    }
  }
}

Herramientas Disponibles:

La integración proporciona un conjunto completo de herramientas para interactuar con Spotify:

• auth-spotify: Autenticación con tu cuenta de Spotify
• search-spotify: Busca contenido musical con consultas en lenguaje natural
• play-track: Inicia la reproducción de canciones específicas
• get-current-playback: Visualiza tu canción actual y el estado de reproducción
• pause-playback: Pausa tu música actual
• next-track/previous-track: Navega por tu cola de reproducción
• get-user-playlists: Visualiza tus listas de reproducción de Spotify
• create-playlist: Crea nuevas listas de reproducción con nombres y descripciones personalizadas
• add-tracks-to-playlist: Añade canciones a listas de reproducción existentes
• get-recommendations: Obtén recomendaciones de música personalizadas basadas en tus preferencias
• get-top-tracks: Obtiene las canciones más reproducidas por el usuario durante un período de tiempo específico

Requisitos del Sistema:

• Node.js 16 o superior
• Cuenta Premium de Spotify para funcionalidad completa de reproducción
• Aplicación Claude Desktop

Consideraciones de Seguridad:

• Los tokens de acceso se almacenan solo en memoria durante las sesiones
• No se almacenan datos de usuario en el disco para proteger la privacidad
• Fácil revocación de acceso a través de la configuración de la cuenta de Spotify

Casos de Uso:

• Creación de listas de reproducción basadas en estados de ánimo mediante IA conversacional
• Control de reproducción musical sin intervención manual
• Descubrimiento de nueva música con recomendaciones personalizadas por IA
• Gestión de la biblioteca Spotify mediante comandos en lenguaje natural
• Análisis de tendencias musicales personales para comprender patrones de escucha
• Generación de playlists retrospectivas basadas en períodos específicos
• Identificación de géneros y artistas preferidos para optimizar recomendaciones

Esta integración muestra el poder de combinar asistentes de IA con servicios de música, creando una experiencia fluida para controlar y explorar tu música a través de conversaciones en lugar de interfaces tradicionales.

---