MCP Spotify Server

ArtistLens

Un potente servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API web de Spotify. ArtistLens permite una interacción fluida con el catálogo de música de Spotify, incluyendo la búsqueda de canciones, álbumes y artistas, así como el acceso a información específica de cada artista, como las canciones más populares y artistas relacionados.

Versión actual: 0.4.12

Instalación

Instalación mediante herrería

Para instalar ArtistLens para Claude Desktop automáticamente a través de Smithery :

Instalación manual

Puede instalar el paquete globalmente:

O ejecútelo directamente con npx:

Configuración

Agregue a su archivo de configuración de MCP (por ejemplo, claude_desktop_config.json o cline_mcp_settings.json ):

Necesitarás proporcionar tus credenciales de API de Spotify:

1. Ir al panel de desarrolladores de Spotify
2. Crear una nueva aplicación
3. Obtenga su ID de cliente y secreto de cliente
4. Agreguelos a la configuración como se muestra arriba

Características

• Buscar pistas, álbumes, artistas y listas de reproducción
• Obtenga información sobre los artistas, incluidas las mejores canciones y artistas relacionados.
• Obtener información del álbum y las pistas
• Accede a nuevos lanzamientos y recomendaciones
• Obtenga información sobre audiolibros con contenido y capítulos específicos del mercado.
• Nota: Los puntos finales de audiolibros pueden requerir autenticación adicional o acceso específico del mercado.
• Obtener y modificar información de la lista de reproducción (nombre, descripción, estado público/privado)
• Acceda a pistas y elementos de listas de reproducción con soporte de paginación
• Compatibilidad con ID y URI de Spotify
• Gestión automática de tokens con flujo de credenciales de cliente
• Conjunto completo de pruebas para todas las funciones
• Código bien organizado con separación de preocupaciones

Herramientas disponibles

• get_access_token : Obtener un token de acceso válido a Spotify
• search : busca pistas, álbumes, artistas o listas de reproducción
• get_artist : Obtener información del artista
• get_artist_top_tracks : Obtener las mejores pistas de un artista
• get_artist_related_artists : Obtener artistas similares a un artista determinado
• get_artist_albums : Obtener los álbumes de un artista
• get_album : Obtener información del álbum
• get_album_tracks : Obtener las pistas de un álbum
• get_track : Obtener información de la pista
• get_available_genres : Obtenga una lista de géneros disponibles para recomendaciones
• get_new_releases : Obtener nuevos lanzamientos de álbumes
• get_recommendations : Obtenga recomendaciones de pistas basadas en pistas iniciales, artistas o géneros
• get_audiobook : obtiene información del audiolibro con el parámetro de mercado opcional
• get_multiple_audiobooks : Obtener información para varios audiolibros (máximo 50)
• get_audiobook_chapters : Obtenga capítulos de un audiolibro con soporte de paginación (1-50 capítulos por solicitud)
• get_playlist : Obtener una lista de reproducción propiedad de un usuario de Spotify
• get_playlist_tracks : obtiene detalles completos de las pistas de una lista de reproducción (1-100 pistas por solicitud)
• get_playlist_items : obtiene detalles completos de los elementos de una lista de reproducción (1-100 elementos por solicitud)
• modify_playlist : Cambia los detalles de la lista de reproducción (nombre, descripción, estado público/privado, estado colaborativo)
• add_tracks_to_playlist : agrega una o más pistas a una lista de reproducción con posición opcional
• remove_tracks_from_playlist : elimina una o más pistas de una lista de reproducción con posiciones opcionales e ID de instantánea
• get_current_user_playlists : obtiene una lista de las listas de reproducción que posee o sigue el usuario actual de Spotify (1 a 50 listas de reproducción por solicitud)
• get_featured_playlists : Obtenga una lista de listas de reproducción destacadas de Spotify con compatibilidad opcional con configuración regional y paginación
• get_category_playlists : Obtenga una lista de listas de reproducción de Spotify etiquetadas con una categoría en particular

Actualizando

Para actualizar a la última versión:

Desarrollo

Este proyecto es de código abierto y está disponible en GitHub en https://github.com/superseoworld/artistlens .

Estructura del proyecto

La base del código está organizada en los siguientes directorios:

• src/handlers/ : Contiene clases de controlador para diferentes puntos finales de la API de Spotify
• src/types/ : Interfaces de TypeScript para objetos de solicitud y respuesta
• src/utils/ : Funciones y clases de utilidad para la comunicación API
• src/__tests__/ : Archivos de prueba de Jest para todas las funciones

Pruebas

El proyecto utiliza Jest para las pruebas. Para ejecutarlas:

Para ejecutar pruebas en modo de observación durante el desarrollo:

Contribuyendo

Para contribuir:

1. Bifurcar el repositorio
2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
3. Añade pruebas para tus cambios
4. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
5. Empujar a la rama ( git push origin feature/amazing-feature )
6. Abrir una solicitud de extracción

Licencia

Licencia MIT