Skip to content

v0.1.0: MusicBrainz WS/2 + Cover Art Archive MCP server

Choose a tag to compare

View all tags
@cyanheads cyanheads released this 13 Jun 17:55
· 13 commits to main since this release
v0.1.0
This tag was signed with the committer’s verified signature.
cyanheads Casey Hand
SSH Key Fingerprint: lkZCAfVCK5qsrcvEYCs0BnVRDCX7pKsdCZkw5yYKMuw
Verified
Learn about vigilant mode.
e804ae7
This commit was signed with the committer’s verified signature.
cyanheads Casey Hand
SSH Key Fingerprint: lkZCAfVCK5qsrcvEYCs0BnVRDCX7pKsdCZkw5yYKMuw
Verified
Learn about vigilant mode.

MusicBrainz WS/2 + Cover Art Archive MCP server

Open music metadata over the live MusicBrainz Web Service v2 and the Cover Art Archive. Keyless, read-only, CC0 core data.

Added:

  • 10 read-only tools: musicbrainz_search_entities (Lucene full-text → ranked MBID + 0–100 score); musicbrainz_get_artist / get_release_group / get_release / get_recording / get_work / get_label (per-entity lookup with inc-folded linked data); musicbrainz_lookup_identifier (ISRC → recordings, ISWC → works, barcode → releases); musicbrainz_browse_entities (complete linked-set enumeration past the one-page inc cap); musicbrainz_get_cover_art (Cover Art Archive images, no-art → empty set).
  • musicbrainz://{entity_type}/{mbid} resource — single entity by type and MBID, mirroring the get_* lookups.
  • musicbrainz-service: mandatory descriptive User-Agent, process-wide ~1 req/sec token-bucket limiter, full-request response cache (MUSICBRAINZ_CACHE_TTL, default 24h), withRetry backoff.
  • cover-art-service: 404 → empty set, follows the release-group 307 redirect.
  • Typed error contracts on the live 400-vs-404 split: invalid_mbid / entity_not_found (lookups), invalid_identifier / identifier_not_found (lookup_identifier), invalid_link / entity_not_found (browse_entities).

Config: MUSICBRAINZ_CONTACT, MUSICBRAINZ_BASE_URL, MUSICBRAINZ_RATE_LIMIT_RPS, MUSICBRAINZ_CACHE_TTL, COVER_ART_BASE_URL.

Built on @cyanheads/mcp-ts-core ^0.10.6. STDIO or Streamable HTTP.

34 tests pass; bun run devcheck clean.

Assets 3
Loading