Spotify MCP Server

Instructions

Implementation Reference

• src/spotify_mcp/fastmcp_server.py:740-788 (handler)

  The main handler function for the 'get_album_info' tool. Decorated with @mcp.tool() for registration and @log_tool_execution. Fetches album details and tracks from Spotify API, parses using Album and Track models, and returns structured data.
  @mcp.tool() @log_tool_execution def get_album_info(album_id: str) -> dict[str, Any]: """Get detailed information about a Spotify album. Args: album_id: Spotify album ID Returns: Dict with album metadata including release_date, label, tracks """ try: logger.info(f"💿 Getting album info: {album_id}") result = spotify_client.album(album_id) album = Album( name=result["name"], id=result["id"], artist=result["artists"][0]["name"] if result.get("artists") else "Unknown", artists=[a["name"] for a in result.get("artists", [])], release_date=result.get("release_date"), release_date_precision=result.get("release_date_precision"), total_tracks=result.get("total_tracks"), album_type=result.get("album_type"), label=result.get("label"), genres=result.get("genres", []), popularity=result.get("popularity"), external_urls=result.get("external_urls"), ) # Parse album tracks tracks = [] for item in result.get("tracks", {}).get("items", []): if item: # Album track items don't have album info, add it item["album"] = { "name": result["name"], "id": result["id"], "release_date": result.get("release_date"), } tracks.append(parse_track(item).model_dump()) return { "album": album.model_dump(), "tracks": tracks, } except SpotifyException as e: raise convert_spotify_error(e) from e
• src/spotify_mcp/fastmcp_server.py:89-104 (schema)

  Pydantic BaseModel schema defining the structure for Spotify album data, used in the get_album_info tool output.
  class Album(BaseModel): """A Spotify album.""" name: str id: str artist: str artists: list[str] | None = None release_date: str | None = None release_date_precision: str | None = None total_tracks: int | None = None album_type: str | None = None label: str | None = None genres: list[str] | None = None popularity: int | None = None external_urls: dict[str, str] | None = None