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
Setup
Requires Python 3.12+ and uv.
git clone https://github.com/zas/mcp-musicbrainz.git
cd mcp-musicbrainz
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
uv run pytest tests/ -v
uv run ruff check .
Pre-commit hooks
Install pre-commit hooks to automatically run linting and formatting on commit, and tests on push:
uv run pre-commit install
Caching
Responses are cached locally in .musicbrainz_cache/ using diskcache with a 24-hour TTL to respect MusicBrainz rate limits.