项目简介

Last.fm MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的强大后端,旨在无缝连接AI助手(如Claude)与Last.fm庞大的音乐数据库。它部署在Cloudflare Workers上,提供全球边缘性能、智能缓存和速率限制,是生产就绪的解决方案,帮助AI助手理解和利用用户的音乐偏好和历史数据。

主要功能点

  • 个人听歌数据: 轻松获取您的最近播放、热门艺术家、专辑和收藏歌曲。
  • 音乐信息查询: 详尽查询任何歌曲、艺术家和专辑的详细信息及统计数据。
  • 音乐发现: 基于您的听歌历史,发现相似艺术家、歌曲和个性化推荐。
  • 听歌统计与分析: 提供全面的听歌统计数据,分析您的音乐习惯和偏好演变。
  • 安全认证: 支持Last.fm Web认证与JWT会话,确保数据访问安全。
  • 时序查询: 革命性功能,允许您询问如“我何时开始听Led Zeppelin?”或“我在2023年夏天着迷于什么?”等历史性音乐问题。
  • 生产级部署: 具备智能缓存、速率限制和Cloudflare Workers的全球边缘优势,确保高性能和稳定性。

服务器配置

要将Last.fm MCP服务器连接到您的AI助手(例如Claude Desktop),您需要将以下配置添加到AI助手的设置中。这告诉AI助手如何找到并使用Last.fm MCP服务。

推荐的Claude Desktop配置(现代HTTP传输): 将以下JSON片段添加到您的Claude Desktop设置文件(通常在“设置 / 开发者 / 编辑配置”中找到):

{
    "mcpServers": {
        "lastfm": {
            "command": "npx",
            "args": ["-y", "@modelcontextprotocol/server-everything", "https://lastfm-mcp-prod.rian-db8.workers.dev"]
        }
    }
}
  • '"mcpServers"': 这是您AI助手中用于管理所有MCP服务器的顶级设置。
  • '"lastfm"': 这是您为Last.fm MCP服务器实例指定的友好名称,您可以自定义。
  • '"command"': AI助手将执行的程序名称。在这里,它使用'npx'来运行一个辅助工具。
  • '"args"': 传递给'command'程序的参数列表。
    • '"-y"': 自动确认'npx'工具的安装提示。
    • '"@modelcontextprotocol/server-everything"': 这是一个代理工具,帮助AI助手通过HTTP协议连接到MCP服务器。
    • '"https://lastfm-mcp-prod.rian-db8.workers.dev"': 这是已部署的Last.fm MCP服务器的实际网络地址。AI助手将通过此地址与服务器通信。

如果您使用Claude Code (命令行工具),则可以更简单地添加: 在您的终端中运行:

claude mcp add --transport http lastfm https://lastfm-mcp-prod.rian-db8.workers.dev

传统Claude Desktop配置(通过mcp-remote代理): 如果您的Claude Desktop版本较旧或遇到问题,可以尝试以下配置,它使用'mcp-remote'代理通过SSE传输连接:

{
    "mcpServers": {
        "lastfm": {
            "command": "npx",
            "args": ["mcp-remote", "https://lastfm-mcp-prod.rian-db8.workers.dev/sse"]
        }
    }
}
  • 此配置与上述现代方法类似,但'args'中的'"mcp-remote"'是另一个代理工具,专门用于服务器发送事件(SSE)传输。
  • '"https://lastfm-mcp-prod.rian-db8.workers.dev/sse"': 这是Last.fm MCP服务器的SSE传输端点地址。

基本使用方法

配置MCP服务器后,您可以通过AI助手与其交互:

  1. 检查认证状态: 在AI助手中尝试调用 'auth_status' 工具。如果未认证,AI助手会提供一个Last.fm认证链接。
  2. 进行认证: 打开提供的Last.fm认证链接,使用您的Last.fm账户登录并授权应用程序。
  3. 开始提问: 认证成功后,您现在可以向AI助手提出关于您的音乐偏好的自然语言问题:
    • “我最近听了什么歌?”
    • “我在2022年最喜欢的艺术家是谁?”
    • “找一些与Pink Floyd相似的艺术家。”
    • “我何时开始听Queen的歌?”
    • “分析我的听歌习惯。”

信息

分类

AI与计算