Lightning FM :: MCP Server

Ein MCP-Server für den Musikkatalog von Lightning FM – Titel suchen, Künstler nachschlagen und prüfen, was gerade auf dem Sender läuft, alles aus einem Agenten heraus.

Es gibt keine separate Agent-API. Dieser Server liest genau das, was ein menschlicher Client liest: kind 31337-Track-Events und kind 0-Profile von öffentlichen Nostr-Relays, Audio und Bilder vom öffentlichen Blossom-Server sowie das kind 30311-Live-Activity-Ereignis, das der Sender bei jedem Titelwechsel veröffentlicht. Jeder Track ist mit dem eigenen Schlüssel des Künstlers signiert – das ist der kanonische Katalog, keine kuratierte Teilmenge, die die Plattform für Agenten pflegt.

Verwendung

Füge es zur Server-Konfiguration deines MCP-Clients hinzu. Für Claude Code oder Claude Desktop:

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

Keine Installation, kein API-Schlüssel, kein Konto. Es spricht standardmäßig mit relay.lightning.fm und media.lightning.fm – siehe Konfiguration, um es woanders hinzurichten.

Werkzeuge

• search_catalog – Volltextsuche plus Genre-/Tag-Filter über den gesamten Katalog. Alle Filter leer lassen, um neueste zuerst zu durchsuchen.

• get_artist – einen Künstler anhand des Anzeigenamens (Teilübereinstimmung), Hex-Pubkey oder npub nachschlagen. Liefert das Profil und die vollständige Diskografie.

• get_now_playing – was gerade auf Sendung ist, und die Stream-URL.

Konfiguration

Alle Umgebungsvariablen sind optional – die Standardwerte zeigen auf die Produktion. Hier ist nichts geheim; dieser Server ist schreibgeschützt und signiert oder veröffentlicht nie etwas.

Entwicklung

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

src/nostr/track.ts spiegelt das kind 31337-Parsing in station-server/src/catalog/track.ts und app-desktop/src-tauri/src/relay.rs. Alle drei müssen sich auf die Tag-Namen einigen – das ist das öffentliche Wire-Format der Plattform, vollständig dokumentiert unter lightning.fm/interop.

Lizenz

MIT