Spotify MCP-Server

Ein einfacher Model Context Protocol (MCP)-Server, der die Interaktion mit Spotify über Claude ermöglicht. Dieser Server ermöglicht es Claude, über Ihr Spotify-Konto nach Songs zu suchen, Playlists zu erstellen, Empfehlungen zu erhalten und vieles mehr.

Merkmale

Suche nach Titeln auf Spotify
Ihr Spotify-Profil anzeigen
Erstellen Sie Wiedergabelisten
Titel zu Wiedergabelisten hinzufügen
Erhalten Sie personalisierte Musikempfehlungen

Verfügbare Tools

Werkzeugname	Beschreibung
`set-spotify-credentials`	Legen Sie Ihre Spotify-Authentifizierungsdaten fest
`check-credentials-status`	Überprüfen Sie, ob Ihre Anmeldeinformationen gültig sind und wer angemeldet ist
`search-tracks`	Suchen Sie nach Titeln nach Name, Interpret oder Schlüsselwörtern
`get-current-user`	Holen Sie sich Ihre Spotify-Profilinformationen
`create-playlist`	Erstellen Sie eine neue Playlist in Ihrem Konto
`add-tracks-to-playlist`	Titel zu einer vorhandenen Playlist hinzufügen
`get-recommendations`	Erhalten Sie Empfehlungen basierend auf Seed-Tracks

Installationsanweisungen

1. Voraussetzungen

Node.js v16 oder höher
npm
Ein Spotify-Konto
Eine registrierte Spotify-Entwickleranwendung

2. Erstellen Sie eine Spotify-Entwickler-App

Gehen Sie zum Spotify Developer Dashboard
Melden Sie sich mit Ihrem Spotify-Konto an
Klicken Sie auf „App erstellen“.
Geben Sie den App-Namen und die Beschreibung ein
Fügen Sie http://localhost:8888/callback als Umleitungs-URI hinzu
Notieren Sie Ihre Client-ID und Ihr Client-Geheimnis

3. Installieren Sie das Projekt

# Clone or download the project first
cd spotify-mcp-server

# Install dependencies
npm install

4. Holen Sie sich Ihre Spotify-Token

Bearbeiten Sie die Datei spotify-auth.js um Ihre Client-ID und Ihr Client-Geheimnis einzuschließen:

// Replace these with your Spotify app credentials
const CLIENT_ID = "your_client_id_here";
const CLIENT_SECRET = "your_client_secret_here";

Führen Sie dann das Authentifizierungsskript aus:

node spotify-auth.js

Dies wird:

Öffnen Sie eine URL in Ihrem Browser
Fordern Sie Sie auf, sich bei Spotify anzumelden
Bitten Sie um Ihre Erlaubnis, auf Ihr Konto zuzugreifen
Speichern Sie die Token in secrets.json

5. Erstellen Sie den MCP-Server

npm run build

6. Konfigurieren Sie Claude Desktop

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Unter Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie die folgende Konfiguration hinzu:

{
  "mcpServers": {
    "spotify": {
      "command": "node",
      "args": ["/full/path/to/spotify-mcp-server/build/spotify-mcp-server.js"]
    }
  }
}

Ersetzen Sie /full/path/to/spotify-mcp-server durch den tatsächlichen Pfad zu Ihrem Projektverzeichnis.

7. Starten Sie Claude Desktop neu

Schließen Sie Claude Desktop und öffnen Sie es erneut, um die neue Konfiguration zu laden.

Verwendung

Wenn Sie eine Unterhaltung mit Claude beginnen, müssen Sie zunächst Ihre Spotify-Anmeldeinformationen festlegen:

Schauen Sie sich Ihre secrets.json -Datei an, um Ihre Anmeldeinformationen zu erhalten
Verwenden Sie das Tool set-spotify-credentials zur Authentifizierung
Dann nutzen Sie eines der anderen Spotify-Tools

Beispiel-Eingabeaufforderungen

Einrichten der Anmeldeinformationen

I want to connect to my Spotify account. Here are my credentials from secrets.json:

Tool: set-spotify-credentials
Parameters:
{
  "clientId": "your_client_id",
  "clientSecret": "your_client_secret",
  "accessToken": "your_access_token",
  "refreshToken": "your_refresh_token"
}

Grundlegende Befehle

Überprüfen Sie Ihr Konto:

Can you check who I'm logged in as on Spotify?

Tool: get-current-user
Parameters: {}

Suche nach Titeln:

Search for songs by Weekend

Tool: search-tracks
Parameters:
{
  "query": "Taylor Swift",
  "limit": 5
}

Erstellen Sie eine Wiedergabeliste:

Create a new playlist called "My Pretty pretty girlfriend"

Tool: create-playlist
Parameters:
{
  "name": "My Pretty pretty girlfriend",
  "description": "For my girlfriend. Created with Claude and the Spotify MCP server"
}

Mehrstufige Aufgaben

Erstellen einer Playlist mit Songs:

I want to create a workout playlist with energetic songs. First, search for some high-energy songs. Then create a playlist called "Workout Mix" and add those songs to it.

Empfehlungen basierend auf Favoriten erhalten:

I like the song "Blinding Lights" by The Weeknd. Can you search for it, then find similar songs, and create a playlist with those recommendations?

Fehlerbehebung

Fehler: Kein Zugriffstoken verfügbar : Sie müssen Ihre Anmeldeinformationen zuerst mit dem Tool set-spotify-credentials festlegen.
Authentifizierungsfehler : Ihre Token sind möglicherweise abgelaufen. Führen Sie das Authentifizierungsskript erneut aus, um neue Token zu erhalten.
Ungültige Anmeldeinformationen : Überprüfen Sie noch einmal, ob Sie die richtige Client-ID und das richtige Client-Geheimnis verwenden.

Hinweise

Der Server speichert Anmeldeinformationen nur im Speicher
Sie müssen jedes Mal Anmeldeinformationen festlegen, wenn Sie eine neue Konversation beginnen
Wenn Claude Desktop neu gestartet wird, müssen Sie die Anmeldeinformationen erneut festlegen

Spotify MCP Server

Integrations