Lightning FM :: MCP 서버

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 — 표시 이름(부분 일치), 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는 station-server/src/catalog/track.ts 및 app-desktop/src-tauri/src/relay.rs의 kind 31337 파싱을 미러링합니다. 세 곳 모두 태그 이름이 일치해야 합니다 — 이것은 플랫폼의 공개 와이어 형식이며, 전체 문서는 lightning.fm/interop에서 확인할 수 있습니다.

라이선스

MIT