What is Spotify Playlist Curator Mcp Server

Spotify-Playlist-Curator-MCP-Server is an MCP server designed to analyze your Spotify playlists and recommend songs using Claude AI based on various musical attributes such as mood, vibe, and BPM.

Use cases

Use cases include curating playlists for different moods or events, discovering new music based on existing playlists, and enhancing user experience in music streaming applications.

How to use

To use the Spotify-Playlist-Curator-MCP-Server, you need to authenticate with your Spotify account, access your playlists, and utilize the provided MCP methods to analyze tracks and receive song recommendations.

Key features

Key features include connecting to your Spotify account, analyzing audio features of tracks, generating summaries of playlist characteristics, getting song recommendations from Claude AI, searching for tracks, adding recommended songs to playlists, and creating new playlists.

Where to use

Spotify-Playlist-Curator-MCP-Server can be used in music curation, personal playlist management, and music recommendation systems, making it suitable for individual users, DJs, and music enthusiasts.

Spotify Playlist Curator MCP Server

An MCP server that helps curate Spotify playlists by analyzing your existing tracks and using Claude AI to recommend songs based on mood, vibe, BPM, and other musical attributes.

Features

• Connect to your Spotify account and access your playlists
• Analyze the audio features of tracks in your playlists
• Generate a summary of playlist mood, energy, tempo, and other characteristics
• Get song recommendations from Claude AI based on the playlist analysis
• Search for tracks on Spotify
• Add recommended tracks to your playlists
• Create new playlists

Setup

Prerequisites

• Node.js (v14 or higher)
• A Spotify Developer account and registered application
• Claude access via MCP (Machine Conversation Protocol)

Installation

1. Clone this repository:

   git clone https://github.com/lechiffre1/Spotify-Playlist-Curator-MCP-Server.git
   cd Spotify-Playlist-Curator-MCP-Server
   

2. Install dependencies:

   npm install
   

3. Create a .env file based on the provided .env.example:

   cp .env.example .env
   

4. Set up your Spotify Developer credentials:

   • Go to Spotify Developer Dashboard
   • Create a new application
   • Add http://localhost:3000/callback as a Redirect URI
   • Copy your Client ID and Client Secret to the .env file

5. Start the server:

   npm start
   

Usage

Authentication

When you start the server, you’ll need to authenticate with Spotify first:

1. Visit http://localhost:3000/login in your browser
2. Log in with your Spotify account and authorize the application
3. After successful authentication, you can close the browser window and return to your MCP client

MCP Methods

The following MCP methods are available:

getPlaylists

Returns a list of your Spotify playlists.

const response = await client.getPlaylists();

getPlaylistDetails

Gets detailed information about a specific playlist, including track analysis.

const response = await client.getPlaylistDetails({
  playlistId: "your_playlist_id"
});

getClaudeRecommendations

Gets song recommendations from Claude AI based on playlist analysis.

const response = await client.getClaudeRecommendations({
  playlistId: "your_playlist_id",
  count: 10 // Optional, defaults to 10
});

addRecommendationsToPlaylist

Adds recommended tracks to a playlist.

const response = await client.addRecommendationsToPlaylist({
  playlistId: "your_playlist_id",
  trackUris: ["spotify:track:id1", "spotify:track:id2", ...]
});

searchTracks

Searches for tracks on Spotify.

const response = await client.searchTracks({
  query: "search query",
  limit: 10 // Optional, defaults to 10
});

createPlaylist

Creates a new Spotify playlist.

const response = await client.createPlaylist({
  name: "My New Playlist",
  description: "Created by Spotify Playlist Curator", // Optional
  isPublic: false // Optional, defaults to false
});

Example Client Usage

import { createClient } from '@anthropic-ai/mcp-client';

async function main() {
  // Create MCP client
  const client = createClient({
    serverUrl: 'http://localhost:3000',
    anthropicApiKey: 'your_anthropic_api_key' // Required for Claude integration
  });

  // 1. Get user playlists
  const playlists = await client.getPlaylists();
  console.log('Your playlists:', playlists);

  // 2. Select a playlist and get its details
  const playlistId = playlists.playlists[0].id;
  const playlistDetails = await client.getPlaylistDetails({ playlistId });
  console.log('Playlist summary:', playlistDetails.summary);

  // 3. Get recommendations from Claude
  const recommendations = await client.getClaudeRecommendations({ playlistId });
  console.log('Claude recommendations:', recommendations.claudeRecommendations);

  // 4. Add recommendations to the playlist
  const trackUris = recommendations.claudeRecommendations
    .filter(track => track.matched)
    .map(track => track.uri);
  
  if (trackUris.length > 0) {
    const result = await client.addRecommendationsToPlaylist({ playlistId, trackUris });
    console.log('Added recommendations:', result);
  }
}

main().catch(console.error);

License

MIT