Spotify MCP Server (express.js)

🚀 Spotify MCP Server (Express.js)

This is a Spotify server implementing the Model Context Protocol (MCP), allowing AI assistants to interact with the Spotify API. The server offers features such as searching for tracks, retrieving artist information, and managing playlists.

🚀 Quick Start

✨ Features

This server enables AI assistants to interact with the Spotify API, providing functions like searching for tracks, getting artist information, and managing playlists.

📦 Installation

1. Create a developer account on the Spotify Developer Console and create a new application on the Spotify Developer Dashboard.
2. Obtain the Client ID and Client Secret from your Spotify application.
3. Create a .env file in the project root directory with the following content:

SPOTIFY_CLIENT_ID=your_client_id
SPOTIFY_CLIENT_SECRET=your_client_secret
SPOTIFY_REDIRECT_URI=http://localhost:3000/callback

4. Install the dependencies:

npm install

5. Start the server:

npm start

💻 Usage Examples

Basic Usage

Here are examples of how an AI assistant can interact with the server:

// Search for tracks
const searchResponse = await fetch('http://localhost:3000/mcp/search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: 'Bohemian Rhapsody',
    type: 'track'
  })
});
const searchData = await searchResponse.json();

// Get artist information
const artistResponse = await fetch('http://localhost:3000/mcp/artist/1dfeR4HaWDbWqJHLk5g1d1');
const artistData = await artistResponse.json();

📚 Documentation

Available Endpoints

The server implements the following MCP endpoints:

• POST /mcp/search - Search for tracks, artists, or albums.
• GET /mcp/artist/{artistId} - Get detailed information about an artist.
• GET /mcp/track/{trackId} - Get detailed information about a track.
• GET /mcp/playlist/{playlistId} - Get information about a playlist.
• GET /mcp/me/top-tracks - Get the user's most frequently listened to songs (authentication required).
• GET /mcp/me/playlists - Get all of the user's playlists (authentication required).
• GET /mcp/me/tracks - Get the user's favorite tracks (authentication required).
• GET /mcp/auth/login - Generate a Spotify login URL for user authentication.
• GET /callback - Handle the Spotify OAuth callback and exchange the authorization code for an access token.
• POST /mcp/auth/refresh - Refresh the user's access token.

MCP Protocol Implementation

The server implements the Model Context Protocol, allowing AI assistants to:

1. Authenticate with Spotify.
2. Search for music content.
3. Get detailed information about artists, tracks, and playlists.
4. Access user - personalized data (with proper authentication).

🔧 Technical Details

The server uses Express.js to implement the MCP endpoints, enabling seamless interaction between AI assistants and the Spotify API. It manages sensitive credentials through environment variables to ensure security.

📄 License

No license information is provided in the original document.

⚠️ Important Note

Ensure the security of the .env file and never commit it to version control. The server manages sensitive credentials through environment variables to ensure security.