MCP 服务器

Spotify Model Context Protocol

Enables creating Spotify playlists based on text descriptions by connecting Cursor editor to Spotify's API through OAuth authentication.

Tools

create_playlist

Create a new playlist on Spotify and add tracks to it. Args: name: Name of the playlist track_uris: List of Spotify track URIs to add to the playlist description: Optional description for the playlist public: Whether the playlist should be public (default: False)

get_track_uris

Look up Spotify track URIs for a list of songs. Args: songs: List of dictionaries containing song information. Each dictionary should have 'name' and 'artist' keys. Example: [{"name": "Yesterday", "artist": "The Beatles"}] Returns: List of Spotify track URIs for the found songs. Songs that couldn't be found will be skipped.

update_playlist

Update an existing Spotify playlist's details and/or tracks. Args: playlist_id: The Spotify ID of the playlist to update name: New name for the playlist (optional) track_uris: New list of track URIs to replace the playlist's tracks (optional) description: New description for the playlist (optional) public: New public/private status for the playlist (optional)

README

Spotify Model Context Protocol (MCP)

A Spotify MCP for creating playlists based on a description.

Prerequisites

Python 3.6 or higher
Spotify Developer credentials (Client ID and Client Secret)

Setup

Clone this repository:

git clone https://github.com/yourusername/spotify-mcp.git
cd spotify-mcp

Install the required dependencies:
```
pip install -r requirements.txt
```
Set up your Spotify Developer credentials:
- Go to Spotify Developer Dashboard
- Create a new application
- Set up your environment variables:
```
echo SPOTIFY_CLIENT_ID='your_client_id' >> .env
echo SPOTIFY_CLIENT_SECRET='your_client_secret' >> .env
```

Usage

Starting the Authentication Server

Set up your redirect URI in the Spotify Developer Dashboard:
- Go to your app in the Spotify Developer Dashboard
- Click "Edit Settings"
- Add http://localhost:5000/callback to the Redirect URIs
- Save the changes
Start the authentication server:
```
python main.py
```
This will start a local server on port 5000 that handles Spotify OAuth authentication.
Visit http://localhost:5000 in your browser to authenticate with Spotify. After successful authentication, your access token will be saved for use with the MCP.

Integrating with Cursor

Open Cursor and go to Settings
Navigate to the "Model Context Protocols" section
Click "Add MCP"
Enter the following details in your mcp.json, replacing PATH-TO-BASE-DIR:

{
  "mcpServers": {
    "spotify": {
        "command": "uv",
        "args": [
          "--directory",
          "PATH-TO-BASE-DIR/spotify-mcp",
          "run",
          "spotify.py"
        ]
    }
  }
}

Now you can use the Spotify MCP commands in Cursor to create and manage playlists directly from your editor!