ArtistLens

基本能力

产品定位

ArtistLens 是一个专注于音乐和音频内容的 MCP 服务器，旨在通过 Spotify Web API 提供丰富的音乐数据访问功能。

核心功能

• 搜索曲目、专辑、艺术家和播放列表
• 获取艺术家信息，包括热门曲目和相关艺术家
• 获取专辑信息和曲目
• 访问新发布和推荐内容
• 获取有声读物信息及其章节
• 获取和修改播放列表信息
• 支持 Spotify IDs 和 URIs
• 自动令牌管理

适用场景

• 音乐推荐系统
• 音乐数据分析
• 播放列表管理
• 音乐内容展示

工具列表

• get_access_token: 获取有效的 Spotify 访问令牌
• search: 搜索曲目、专辑、艺术家或播放列表
• get_artist: 获取艺术家信息
• get_artist_top_tracks: 获取艺术家的热门曲目
• get_artist_related_artists: 获取与给定艺术家相似的艺术家
• get_artist_albums: 获取艺术家的专辑
• get_album: 获取专辑信息
• get_album_tracks: 获取专辑的曲目
• get_track: 获取曲目信息
• get_available_genres: 获取可用于推荐的流派列表
• get_new_releases: 获取新发布的专辑
• get_recommendations: 基于种子曲目、艺术家或流派获取曲目推荐
• get_audiobook: 获取有声读物信息
• get_multiple_audiobooks: 获取多个有声读物的信息
• get_audiobook_chapters: 获取有声读物的章节
• get_playlist: 获取 Spotify 用户拥有的播放列表
• get_playlist_tracks: 获取播放列表的曲目详细信息
• get_playlist_items: 获取播放列表的项目详细信息
• modify_playlist: 修改播放列表详细信息
• add_tracks_to_playlist: 向播放列表添加曲目
• remove_tracks_from_playlist: 从播放列表中移除曲目
• get_current_user_playlists: 获取当前 Spotify 用户拥有或关注的播放列表列表
• get_featured_playlists: 获取 Spotify 特色播放列表列表
• get_category_playlists: 获取标记有特定类别的 Spotify 播放列表列表

常见问题解答

• 如何获取 Spotify API 凭证？
• 访问 Spotify Developer Dashboard
• 创建一个新应用
• 获取您的 Client ID 和 Client Secret
• 将它们添加到配置中

使用教程

使用依赖

需要安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

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

手动安装

全局安装：

npm install -g @thomaswawra/artistlens

或直接运行：

npx -y @thomaswawra/artistlens

配置

添加到 MCP 设置文件（例如 claude_desktop_config.json 或 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": []
    }
  }
}

调试方式

运行测试：

npm test

开发模式下运行测试：

npm run test:watch

更新

全局更新：

npm update -g @thomaswawra/artistlens

使用 npx 自动使用最新版本：

npx -y @thomaswawra/artistlens

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。