Spotify MCP Server

Instructions

Implementation Reference

• src/spotify_mcp/spotify_api.py:236-290 (handler)

  Core handler function that implements the logic for retrieving detailed information about Spotify items (track, album, artist, playlist) using Spotipy API.
  def get_info(self, item_uri): """Gets detailed information about a Spotify item based on its URI.""" item_id = self._extract_id_from_uri(item_uri) if 'track' in item_uri: item = self.sp.track(item_id) info = { 'type': 'track', 'name': item['name'], 'artists': [artist['name'] for artist in item['artists']], 'album': item['album']['name'], 'duration_ms': item['duration_ms'], 'popularity': item['popularity'], 'uri': item['uri'], 'external_url': item['external_urls']['spotify'] if 'external_urls' in item else None } elif 'playlist' in item_uri: item = self.sp.playlist(item_id) info = { 'type': 'playlist', 'name': item['name'], 'owner': item['owner']['display_name'], 'description': item['description'], 'tracks_total': item['tracks']['total'], 'followers': item['followers']['total'], 'uri': item['uri'], 'external_url': item['external_urls']['spotify'] if 'external_urls' in item else None } elif 'album' in item_uri: item = self.sp.album(item_id) info = { 'type': 'album', 'name': item['name'], 'artists': [artist['name'] for artist in item['artists']], 'release_date': item['release_date'], 'total_tracks': item['total_tracks'], 'popularity': item['popularity'], 'uri': item['uri'], 'external_url': item['external_urls']['spotify'] if 'external_urls' in item else None } elif 'artist' in item_uri: item = self.sp.artist(item_id) info = { 'type': 'artist', 'name': item['name'], 'genres': item['genres'], 'followers': item['followers']['total'], 'popularity': item['popularity'], 'uri': item['uri'], 'external_url': item['external_urls']['spotify'] if 'external_urls' in item else None } else: raise ValueError(f"Unsupported URI type: {item_uri}") return info
• src/spotify_mcp/server.py:72-77 (schema)

  Input schema definition for the SpotifyGetInfo tool using Pydantic model, specifying the required item_uri parameter.
  class GetInfo(ToolModel): """Get detailed information about a Spotify item (track, album, artist, or playlist).""" item_uri: str = Field(description="URI of the item to get information about. " + "If 'playlist' or 'album', returns its tracks. " + "If 'artist', returns albums and top tracks.")
• src/spotify_mcp/server.py:119-125 (registration)

  Registration of the SpotifyGetInfo tool (as 'SpotifyGetInfo') in the MCP server's list_tools method via GetInfo.as_tool().
  tools = [ Playback.as_tool(), Search.as_tool(), Queue.as_tool(), GetInfo.as_tool(), Playlist.as_tool(), ]
• src/spotify_mcp/server.py:435-443 (handler)

  MCP server tool handler that processes calls to SpotifyGetInfo by invoking the spotify_client.get_info method and returning JSON response.
  case "GetInfo": logger.info(f"Getting item info with arguments: {arguments}") item_info = spotify_client.get_info( item_uri=arguments.get("item_uri") ) return [types.TextContent( type="text", text=json.dumps(item_info, indent=2) )]
• src/spotify_mcp/spotify_api.py:292-310 (helper)

  Helper method used by get_info to extract the Spotify resource ID from the provided URI.
  def _extract_id_from_uri(self, uri): """Extracts the ID portion from a Spotify URI.""" # Handle different URI formats # spotify:type:id # https://open.spotify.com/type/id if uri.startswith('spotify:'): parts = uri.split(':') return parts[-1] elif uri.startswith('http'): # Extract the path and split by '/' from urllib.parse import urlparse path = urlparse(uri).path parts = path.split('/') # The ID should be the last part return parts[-1] else: # Assume it's just the ID return uri @utils.validate