io.github.maml/lightning-fm-mcp MCP Server

Name: io.github.maml/lightning-fm-mcp MCP Server
Author: io.github.maml

io.github.maml/lightning-fm-mcp

Repository Registry

What is the io.github.maml/lightning-fm-mcp MCP server?

Search Lightning FM's Nostr music catalog, look up artists, and check what's live now.

How to install io.github.maml/lightning-fm-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

LFM_NOSTR_RELAYS
Comma-separated relay URLs to query. Only add a relay here if it gates writes the way relay.lightning.fm does (allowlisted artists only) — an unrestricted public relay hands back every other app's kind-31337 events too, not just Lightning FM's.
LFM_BLOSSOM_URL
Blossom server audio/image hashes resolve against.
LFM_CACHE_TTL_MS
How long a fetched catalog/profile/now-playing snapshot is reused, in milliseconds, before the next tool call re-queries the relays.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lightning-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-fm-mcp"
      ],
      "env": {
        "LFM_NOSTR_RELAYS": "<YOUR_LFM_NOSTR_RELAYS>",
        "LFM_BLOSSOM_URL": "<YOUR_LFM_BLOSSOM_URL>",
        "LFM_CACHE_TTL_MS": "<YOUR_LFM_CACHE_TTL_MS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "lightning-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-fm-mcp"
      ],
      "env": {
        "LFM_NOSTR_RELAYS": "<YOUR_LFM_NOSTR_RELAYS>",
        "LFM_BLOSSOM_URL": "<YOUR_LFM_BLOSSOM_URL>",
        "LFM_CACHE_TTL_MS": "<YOUR_LFM_CACHE_TTL_MS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "lightning-fm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-fm-mcp"
      ],
      "env": {
        "LFM_NOSTR_RELAYS": "<YOUR_LFM_NOSTR_RELAYS>",
        "LFM_BLOSSOM_URL": "<YOUR_LFM_BLOSSOM_URL>",
        "LFM_CACHE_TTL_MS": "<YOUR_LFM_CACHE_TTL_MS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "lightning-fm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lightning-fm-mcp"
      ],
      "env": {
        "LFM_NOSTR_RELAYS": "<YOUR_LFM_NOSTR_RELAYS>",
        "LFM_BLOSSOM_URL": "<YOUR_LFM_BLOSSOM_URL>",
        "LFM_CACHE_TTL_MS": "<YOUR_LFM_CACHE_TTL_MS>"
      }
    }
  }
}

Claude Code

claude mcp add lightning-fm-mcp --env LFM_NOSTR_RELAYS=<YOUR_LFM_NOSTR_RELAYS> --env LFM_BLOSSOM_URL=<YOUR_LFM_BLOSSOM_URL> --env LFM_CACHE_TTL_MS=<YOUR_LFM_CACHE_TTL_MS> -- npx -y lightning-fm-mcp