使用说明

项目简介

Rocksky CLI 是去中心化音乐追踪和发现平台 Rocksky (https://rocksky.app) 的官方命令行工具。除了提供常规的 CLI 功能外，它还包含一个基于 Model Context Protocol (MCP) 实现的服务器，允许大语言模型 (LLM) 客户端通过标准化接口访问 Rocksky 平台的数据和功能。

主要功能点

该 MCP 服务器通过提供一系列“工具”来增强 LLM 的能力，包括：

用户信息查询: 获取当前登录用户的详细信息 ('whoami')。
正在播放查询: 查看用户当前正在播放的音乐 ('nowplaying')。
听歌记录查询: 查看最近的听歌记录，支持查询指定用户或公共记录 ('scrobbles', 'my-scrobbles')。
音乐数据搜索: 在 Rocksky 平台上搜索歌曲、专辑、艺术家或用户 ('search')。
音乐统计数据查询: 查看用户的听歌统计信息 ('stats')。
排行榜查询: 查看用户的热门艺术家、专辑和歌曲排行榜 ('artists', 'albums', 'tracks')。
API 密钥管理: 创建用于 Rocksky API 访问的密钥 ('create-apikey')。

安装步骤

确保你的系统已安装 Node.js 或 Bun。然后通过 npm 或 npx 进行安装：

使用 npm 全局安装：

npm install -g @rocksky/cli

或使用 npx 直接运行（无需全局安装）：

npx @rocksky/cli <command> [options]

安装完成后，首次使用前通常需要登录 Rocksky 账户以授权访问你的数据：

rocksky login <你的BlueSky账号Handle>

按照提示完成浏览器中的 OAuth 授权流程。

服务器配置

此 MCP 服务器作为 Rocksky CLI 的一个子命令运行，并通过标准输入/输出 (Stdio) 与客户端通信。对于支持 MCP 的 LLM 客户端，你需要提供以下配置信息以便客户端启动并连接到此服务器：

客户端通常需要配置服务器的启动命令和参数，以及服务器的名称。以下是对应的 JSON 配置信息格式：

{
  "name": "rocksky-mcp", // MCP 服务器在此配置中使用的名称
  "command": ["rocksky"], // 启动服务器的可执行命令（如果rocksky已在PATH中）
  "args": ["mcp"] // 传递给 rocksky 命令以启动 MCP 服务器的参数
  // 如果需要指定Node.js路径或使用npx，command和args可能需要调整
  // 例如，使用npx： "command": ["npx"], "args": ["@rocksky/cli", "mcp"]
}

具体的配置方式取决于你使用的 MCP 客户端软件。

基本使用方法

要启动 Rocksky MCP 服务器，只需运行 Rocksky CLI 的 'mcp' 命令：

rocksky mcp

执行此命令后，CLI 将进入 MCP 服务器模式，通过标准输入和输出等待 LLM 客户端的连接和 JSON-RPC 请求。通常这个命令是由 MCP 客户端应用在后台启动的。

用户无需直接与此命令交互，它设计为供支持 MCP 协议的客户端应用程序（如某些 LLM 界面）调用。

关键词