remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to the Spotify Web API, enabling search for tracks, albums, artists, and playlists, as well as accessing artist information, top tracks, related artists, album information, new releases, recommendations, audiobook information, and playlist management.

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 :

npx -y @smithery/cli install @superseoworld/artistlens --client claude

Instalación manual

Puede instalar el paquete globalmente:

npm install -g @thomaswawra/artistlens

O ejecútelo directamente con npx:

npx -y @thomaswawra/artistlens

Configuración

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

{
  "mcpServers": {
    "spotify": {
      "command": "npx",
      "args": ["-y", "@thomaswawra/artistlens"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Necesitarás proporcionar tus credenciales de API de Spotify:

Ir al panel de desarrolladores de Spotify
Crear una nueva aplicación
Obtenga su ID de cliente y secreto de cliente
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:

# If installed globally
npm update -g @thomaswawra/artistlens

# If using npx, it will automatically use the latest version
npx -y @thomaswawra/artistlens

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:

npm test

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

npm run test:watch

Contribuyendo

Para contribuir:

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

Licencia

Licencia MIT

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Permite la interacción con el catálogo de música de Spotify a través de la API web de Spotify, lo que admite búsquedas, recuperación de información de artistas, gestión de listas de reproducción y manejo automático de tokens.

Related Resources

Reddit Discussion about this server

MCP Spotify Server