Lightning FM :: MCP Server

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 — 表示名（部分一致）、16 進パブキー、または 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 解析を反映しています。3 つすべてがタグ名について一致している必要があります — これはプラットフォームの公開ワイヤーフォーマットであり、lightning.fm/interop に完全なドキュメントがあります。

ライセンス

MIT