项目简介

ArtistLens 是一个强大的 Model Context Protocol (MCP) 服务器，它充当 LLM 客户端和 Spotify Web API 之间的桥梁。通过 ArtistLens，LLM 应用可以便捷地访问 Spotify 丰富的音乐数据，实现音乐搜索、艺术家和专辑信息查询、播放列表管理等功能，从而扩展 LLM 在音乐领域的应用场景。

主要功能点

全面的 Spotify 数据访问: 支持搜索曲目、专辑、艺术家和播放列表，获取艺术家专辑、热门歌曲、相关艺术家等详细信息。
播放列表管理: 允许 LLM 应用获取、修改用户播放列表，包括添加、删除曲目，修改播放列表名称、描述和公开状态。
音频内容支持: 除了音乐，还支持访问 Spotify 上的有声读物信息，包括章节列表。
标准化 MCP 接口: 通过标准的 MCP 协议与 LLM 客户端通信，提供稳定可靠的上下文服务。
易于安装和配置: 提供 Smithery 自动安装和手动安装方式，配置简单，只需提供 Spotify API 凭据。

安装步骤

ArtistLens 支持通过 Smithery 自动安装或手动全局安装。

通过 Smithery 安装 (推荐 Claude Desktop 用户)

如果您使用 Claude Desktop，可以通过 Smithery 自动安装 ArtistLens：

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

手动全局安装

您也可以使用 npm 全局安装 ArtistLens：

npm install -g @thomaswawra/artistlens

或者使用 npx 直接运行：

npx -y @thomaswawra/artistlens

服务器配置

要将 ArtistLens 配置为 MCP 服务器，您需要将其添加到 MCP 客户端的配置文件中（例如 'claude_desktop_config.json' 或 'cline_mcp_settings.json'）。以下是一个配置示例，server name 可以自定义，command 和 args 必须按照示例填写，env 中 SPOTIFY_CLIENT_ID 和 SPOTIFY_CLIENT_SECRET 需要替换为您自己的 Spotify API 凭据。

{
  "mcpServers": {
    "spotify": { // 自定义 server name，例如 "spotify"
      "command": "npx", // 启动命令，固定为 "npx"
      "args": ["-y", "@thomaswawra/artistlens"], // 启动参数，固定为 ["-y", "@thomaswawra/artistlens"]
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id", // 替换为您的 Spotify Client ID
        "SPOTIFY_CLIENT_SECRET": "your_client_secret" // 替换为您的 Spotify Client Secret
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

获取 Spotify API 凭据步骤：

访问 Spotify Developer Dashboard
创建一个新的应用 (Create an App)
获取您的 Client ID 和 Client Secret
将 Client ID 和 Client Secret 填入上述配置文件的 'SPOTIFY_CLIENT_ID' 和 'SPOTIFY_CLIENT_SECRET' 中

基本使用方法

配置完成后，您的 MCP 客户端（如 Claude）应该能够检测到 ArtistLens 服务器。您可以使用客户端的工具列表功能 (例如 Claude 的 '@list_tools') 查看 ArtistLens 提供的工具。

例如，要搜索 "Coldplay" 艺术家的歌曲，您可以使用 'search' 工具并提供相应的参数：

{
  "tool_code": "@spotify.search",
  "tool_parameters": {
    "query": "Coldplay",
    "type": "track"
  }
}

ArtistLens 提供了丰富的工具，您可以参考 Available Tools 章节了解所有可用的工具及其参数。

注意: 部分功能（例如播放列表管理）可能需要用户进行 Spotify 账号授权，具体取决于 MCP 客户端的实现。目前 ArtistLens 使用 Client Credentials Flow 进行 API 鉴权，主要用于公开数据的访问，部分需要用户授权的功能可能受限。

关键词