Spotify MCP Node Server

Instructions

Implementation Reference

• src/read.ts:131-193 (handler)

  The main handler function for the 'getNowPlaying' tool. It fetches the currently playing track using the Spotify API, validates it's a track, formats details like artists, album, progress, and returns a markdown-formatted response.
  handler: async (args, extra: SpotifyHandlerExtra) => { try { const currentTrack = await handleSpotifyRequest(async (spotifyApi) => { return await spotifyApi.player.getCurrentlyPlayingTrack(); }); if (!currentTrack || !currentTrack.item) { return { content: [ { type: 'text', text: 'Nothing is currently playing on Spotify', }, ], }; } const item = currentTrack.item; if (!isTrack(item)) { return { content: [ { type: 'text', text: 'Currently playing item is not a track (might be a podcast episode)', }, ], }; } const artists = item.artists.map((a) => a.name).join(', '); const album = item.album.name; const duration = formatDuration(item.duration_ms); const progress = formatDuration(currentTrack.progress_ms || 0); const isPlaying = currentTrack.is_playing; return { content: [ { type: 'text', text: `# Currently ${isPlaying ? 'Playing' : 'Paused'}\n\n` + `**Track**: "${item.name}"\n` + `**Artist**: ${artists}\n` + `**Album**: ${album}\n` + `**Progress**: ${progress} / ${duration}\n` + `**ID**: ${item.id}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error getting current track: ${ error instanceof Error ? error.message : String(error) }`, }, ], }; } },
• src/read.ts:130-130 (schema)

  Empty input schema indicating the tool takes no parameters.
  schema: {},
• src/read.ts:521-529 (registration)

  The readTools array exports that includes the getNowPlaying tool for grouping read-related tools.
  export const readTools = [ searchSpotify, getNowPlaying, getUserPlaylists, getPlaylistTracks, getRecentlyPlayed, getFollowedArtists, getUserTopItems, ];
• src/index.ts:12-14 (registration)

  Final registration of all tools, including getNowPlaying via the spread readTools, calling server.tool() for each.
  [...playTools, ...readTools, ...writeTools].forEach((tool) => { server.tool(tool.name, tool.description, tool.schema, tool.handler); });
• src/read.ts:6-14 (helper)

  Helper function used in the handler to type-guard if the playing item is a track.
  function isTrack(item: any): item is SpotifyTrack { return ( item && item.type === 'track' && Array.isArray(item.artists) && item.album && typeof item.album.name === 'string' ); }