Lightning FM :: MCP 服务器

一个用于 Lightning FM 音乐目录的 MCP 服务器——供智能体搜索曲目、查找艺术家，并查看电台正在播放的内容。

没有单独的智能体 API。此服务器读取的正是人类客户端所读取的内容：来自公共 Nostr 中继的 kind 31337 曲目事件和 kind 0 个人资料、来自公共 Blossom 服务器的音频和图片，以及电台在每次曲目切换时发布的 kind 30311 实时活动事件。每首曲目都由艺术家自己的密钥签名——这是权威目录，而非平台为智能体维护的精选子集。

使用

将其添加到你的 MCP 客户端的服务器配置中。对于 Claude Code 或 Claude Desktop：

{
  "mcpServers": {
    "lightning-fm": {
      "command": "npx",
      "args": ["-y", "lightning-fm-mcp"]
    }
  }
}

无需安装、无需 API 密钥、无需账户。默认情况下，它会与 relay.lightning.fm 和 media.lightning.fm 通信——如需指向其他位置，请参阅 配置。

工具

• search_catalog — 对整个目录进行自由文本搜索，并支持流派/标签筛选。将所有筛选条件留空即可按最新优先浏览。

• get_artist — 按显示名称（部分匹配）、十六进制公钥或 npub 查找艺术家。返回其个人资料和完整唱片目录。

• get_now_playing — 当前正在播出的内容，以及流媒体 URL。

配置

所有环境变量都是可选的——默认值指向生产环境。这里没有任何秘密；此服务器是只读的，从不签名或发布任何内容。

开发

npm install
npm run dev     # runs src/index.ts directly via tsx
npm run build   # tsc -> dist/

src/nostr/track.ts 与 station-server/src/catalog/track.ts 和 app-desktop/src-tauri/src/relay.rs 中的 kind 31337 解析保持一致。三者必须就标签名称达成一致——这是平台的公共线上格式，完整文档见 lightning.fm/interop。

许可证

MIT