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:

Related MCP server: Spotify-Claude MCP Server

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