MusicBrainz MCP Server

Instructions

Implementation Reference

• mcp_musicbrainz/server.py:742-766 (handler)

  The tool `get_cover_art_urls` handler implemented in `server.py` using `musicbrainzngs` to fetch cover art.

  @mcp.tool()
  @cached_tool()
  def get_cover_art_urls(release_id: str) -> str:
      """Get cover art image URLs for a specific release (edition)
      from the Cover Art Archive.
      Takes a release_id, NOT a release_group_id.
      Returns URLs for front/back covers and thumbnails."""
      images = musicbrainzngs.get_image_list(release_id)
      img_list = images.get("images", [])
      if not img_list:
          return "No cover art images available."
      lines = [f"Cover art for release {release_id} ({len(img_list)} images):"]
      for img in img_list:
          types = ", ".join(img.get("types", ["Unknown"]))
          lines.append(f"- [{types}] {img.get('image', 'N/A')}")
          thumbs = img.get("thumbnails", {})
          if thumbs:
              thumb_url = thumbs.get("500") or thumbs.get("large", "")
              if thumb_url:
                  lines.append(f"  Thumbnail: {thumb_url}")
      return "\n".join(lines)
  
  
  @mcp.tool()
  @cached_tool()