lightning-fm-mcp

Lightning FM :: MCP Server

Un servidor MCP para el catálogo musical de Lightning FM: busca pistas, consulta artistas y comprueba qué está sonando en la emisora, todo desde un agente.

No existe una API de agente separada. Este servidor lee exactamente lo que lee un cliente humano: eventos de pista kind 31337 y perfiles kind 0 de relays públicos de Nostr, audio e imágenes del servidor público de Blossom, y el evento de actividad en vivo kind 30311 que la emisora publica en cada cambio de pista. Cada pista está firmada con la propia clave del artista: este es el catálogo canónico, no un subconjunto seleccionado que la plataforma mantenga para agentes.

Úsalo

Añádelo a la configuración de servidores de tu cliente MCP. Para Claude Code o Claude Desktop:

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

Sin instalación, sin clave de API, sin cuenta. Habla con relay.lightning.fm y media.lightning.fm por defecto: consulta Configuración para apuntarlo a otro sitio.

Herramientas

• search_catalog — búsqueda de texto libre más filtros por género/etiqueta en todo el catálogo. Deja todos los filtros vacíos para explorar de más reciente a más antiguo.

• get_artist — busca un artista por nombre visible (coincidencia parcial), clave pública hexadecimal o npub. Devuelve su perfil y discografía completa.

• get_now_playing — qué está sonando actualmente en antena y la URL del stream.

Configuración

Todas las variables de entorno son opcionales: los valores por defecto apuntan a producción. Nada de esto es un secreto; este servidor es de solo lectura y nunca firma ni publica nada.

Desarrollo

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

src/nostr/track.ts replica el parseo del kind 31337 en station-server/src/catalog/track.ts y app-desktop/src-tauri/src/relay.rs. Los tres deben coincidir en los nombres de las etiquetas: este es el formato público de intercambio de la plataforma, documentado por completo en lightning.fm/interop.

Licencia

MIT