Lightning FM :: MCP Server

MCP-сервер для музыкального каталога Lightning FM — поиск треков, просмотр исполнителей и проверка того, что сейчас в эфире на станции, — всё это из агента.

Отдельного API для агентов нет. Этот сервер читает ровно то же, что читает клиент-человек: события треков kind 31337 и профили kind 0 с публичных реле Nostr, аудио и изображения с публичного сервера Blossom, а также событие live-активности 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 — поиск исполнителя по отображаемому имени (частичное совпадение), hex-pubkey или 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 повторяет разбор kind 31337 из station-server/src/catalog/track.ts и app-desktop/src-tauri/src/relay.rs. Все три должны совпадать по именам тегов — это публичный формат обмена данными платформы, полностью описанный на lightning.fm/interop.

Лицензия

MIT