README.md•2 kB
# Spotify-Claude MCP Server
A tool that connects to the Spotify API and uses Claude as an AI assistant for enhanced music discovery and interaction.
## Overview
This project integrates Claude AI with the Spotify API through a Model Control Protocol (MCP) server. It allows users to interact with their Spotify account using natural language queries processed by Claude.
## Features
Currently the claude can get the Artist information using the SpotifyAPI. This can be extended for other queries, such as getting top tracks, or genres, creating playlists, or getting user profile data
## Prerequisites
- Spotify Developer Account
- Spotify API credentials (Client ID and Client Secret)
- Claude Desktop
## Installation
1. Clone the repository:
```
git clone https://github.com/DivyamAgg24/SpotifyMCP.git
cd SpotifyMCP
```
2. Install dependencies:
```
npm install
```
3. Set up environment variables:
Create a .env file in the root directory with the following variables:
```
SPOTIFY_CLIENT_ID=your_spotify_client_id
SPOTIFY_CLIENT_SECRET=your_spotify_client_secret
SPOTIFY_ACCESS_TOKEN=access_token_obtained_from_clientId_and_clientSecret
```
## Configuration
Register your app in the Spotify Developer Dashboard
Add http://localhost:8888/callback as a Redirect URI in your Spotify app settings
Copy the Client ID and Client Secret to your .env file
Usage
1. Build the project
```
tsc -b
```
2. Add MCP Server configuration in Claude config file
3. Prompt Claude about the name of the artist
## Tool Functions
The MCP server exposes the following function to Claude:
get_artist(name): Retrieves information about an artist
Example Interactions
```
User: "What is the artist name?"
Claude: [Uses get_artist function] "The artist name is Pitbull."
```
MCP Server: Handles communication between Claude and the Spotify API
Spotify API Client: Manages authentication and API requests to Spotify
Claude Integration: Processes natural language and determines which functions to call