Spotify MCP Server Cv6

🚀 Spotify Multi-Purpose Console (MCP) Server Guide

Spotify Multi-Purpose Console (MCP) Server is a Node.js-based tool that allows users to interact with Spotify services through a Command Line Interface (CLI). This tool supports multiple functions, including music playback control, data retrieval, and system settings.

🚀 Quick Start

Prerequisites

1. Node.js v16+ installed
2. A Spotify Premium account
3. A registered Spotify developer application

Installation Steps

git clone https://github.com/marcelmarais/spotify-mcp-server.git
cd spotify-mcp-server
npm install
npm run build

Create a Spotify Developer Application

1. Visit the Spotify Developer Dashboard.
2. Log in with your Spotify account.
3. Click the "Create a new app" button.
4. Fill in the app name and description.
5. Accept the terms of service and click "Create".
6. In the new app's dashboard, view your Client ID.
7. Click "Show client secret" to display your Client Secret.
8. Click "Edit settings" and add a redirect URI (e.g., http://localhost:8888/callback).
9. Save the changes.

Spotify API Configuration

Create a spotify-config.json file in the project root directory (you can copy and modify the provided example):

cp example.spotify-config.json .spotify-config.json

Edit the configuration file:

{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "redirectUri": "http://localhost:8888/callback"
}

✨ Features

Core Commands

1. Playback Control

   • play: Start playing music
   • pause: Pause playback
   • resume: Resume playback
   • stop: Stop playback
   • toggle: Toggle playback state (play/pause)

2. Media Operations

   • next: Skip to the next song
   • previous: Go back to the previous song
   • repeat: Enable repeat playback mode
   • shuffle: Shuffle the current playlist

3. Volume Adjustment

   • volume <percentage>: Adjust the volume (range: 0 - 100)
   • mute: Mute the sound
   • unmute: Unmute the sound

4. Time Adjustment

   • seek <seconds>: Jump to the specified number of seconds
   • replay: Replay the current music

Advanced Features

1. Playlist Management

   • create-playlist "<playlist-name>": Create a new playlist
   • add-to-playlist "<track-id>" "<playlist-name>": Add a song to the specified playlist
   • remove-from-playlist "<track-id>" "<playlist-name>": Remove a song from the playlist
   • delete-playlist "<playlist-name>": Delete the specified playlist

2. Favorite Management

   • save-track "<track-id>": Add a song to the "liked" list
   • remove-track "<track-id>": Remove a song from the "liked" list

3. User Data Query

   • get-playlists: Get information about all playlists
   • get-tracks "<playlist-name>": Get all tracks in the specified playlist
   • get-current: View information about the currently playing music
   • search "<query>": Search for songs or artists

4. System Settings

   • set-device "<device-id>": Switch the default audio device
   • set-destination "<endpoint>": Configure the media data transfer address

💻 Usage Examples

Authorization Login

Run the following command to authorize with your Spotify account:

npm run authorize

Follow the prompts to complete the OAuth process.

Basic Operations

• Play music: npm run play
• Pause playback: npm run pause
• Next song: npm run next
• Previous song: npm run previous

Complex Tasks

• Create a new playlist:

  npm run create-playlist "My New Playlist"
  

• Add a song to a playlist:

  npm run add-to-playlist "123456789" "My New Playlist"
  

🔧 Technical Details

Environment Variable Settings

You can use the following environment variables to further customize the tool:

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

Add these variables to your .env file.

Integration with Development Tools

1. Claude Desktop

   • Install the Claude plugin.
   • Configure environment variables.
   • Use commands to call Spotify functions.

2. Cursor

   • Install the Cursor plugin.
   • Add custom shortcuts.
   • Integrate the MCP service.

3. VS Code

   • Install the corresponding extension.
   • Configure startup tasks.
   • Use the plugin for operations.

📚 Documentation

• Node.js Official Documentation
• Spotify API Documentation
• Developer Guide

By following the above steps, you can easily configure and use the Spotify Multi-Purpose Console Server to achieve efficient management and automated operations of Spotify services.