mcp-musicbrainz

An MCP (Model Context Protocol) server that provides tools for querying the MusicBrainz music database. Search for artists, albums, recordings, labels, and more — directly from your AI assistant.

Tools

Tool	Description
search_entities	Search for any MusicBrainz entity using Lucene syntax. Primary entry point
search_entities_fuzzy	Typo-tolerant search with automatic exact-first fallback
search_artists	Search for artists with filters (country, type, gender)
search_releases	Search for releases with filters (title, artist, label, barcode)
browse_entities	Browse entities linked to another entity with paging (e.g. all releases by an artist)
get_artist_details	Artist info with aliases, genres, ratings, URLs, and first 10 release groups
get_artist_discography	Full paged discography (release groups) for an artist
get_release_details	Release (specific edition) tracklist, barcode, label, and catalog number
get_release_group_details	Release group (album concept) details with type, genres, and editions
get_recording_details	Recording info with appearances, ISRCs, and genres
get_album_tracks	Tracklist with durations for a release group
get_work_details	Musical work details with composers and lyricists
get_area_details	Geographic area info (country, city) with aliases
get_label_details	Label info with type, area, genres, and URLs
get_entity_relationships	Relationships for any entity type (band members, producers, etc.)
get_cover_art_urls	Cover art image URLs from the Cover Art Archive
lookup_by_barcode	Find a release by UPC/EAN barcode

Setup

Requires Python 3.12+ and uv.

git clone https://github.com/zas/mcp-musicbrainz.git
cd mcp-musicbrainz
uv venv
uv sync

Usage

Standalone

uv run mcp-musicbrainz

Claude Desktop

Add to claude_desktop_config.json:

Kiro CLI

Add to ~/.kiro/settings/mcp.json:

Cursor

Add to .cursor/mcp.json in your project:

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

All use the same configuration:

{
  "mcpServers": {
    "musicbrainz": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-musicbrainz", "mcp-musicbrainz"]
    }
  }
}

Development

uv sync --all-groups
uv run pytest tests/ -v
uv run ruff check .

Caching

Responses are cached locally in .musicbrainz_cache/ using diskcache with a 24-hour TTL to respect MusicBrainz rate limits.

License

GPL-3.0-or-later