Spotify MCP-Server

Ein Model Context Protocol (MCP)-Server, der Werkzeuge für die Interaktion mit der Spotify Web API bereitstellt. Ermöglicht KI-Assistenten wie Claude das Suchen von Musik, Steuern der Wiedergabe, Verwalten von Playlists und mehr.

Funktionen

• Suche - Finde Titel, Alben, Künstler, Playlists, Shows, Episoden und Hörbücher

• Wiedergabesteuerung - Abspielen, Pause, Überspringen, Suchen, Lautstärke, Zufallswiedergabe, Wiederholung, Warteschlangenverwaltung

• Playlists - Erstellen, Aktualisieren, Hinzufügen/Entfernen/Neuanordnen von Titeln

• Bibliothek - Anzeigen und Verwalten gespeicherter Titel, Alben, Shows, Episoden und Hörbücher

• Durchsuchen - Abrufen von Albumdetails, Künstlerinformationen, Titel-Metadaten

• Podcasts & Hörbücher - Durchsuchen von Shows, Episoden, Hörbüchern und Kapiteln

• Benutzerprofil - Profil anzeigen, Top-Künstler/-Titel, gefolgte Künstler

• 44 Werkzeuge, die nicht als veraltet markierte Spotify Web API-Endpunkte abdecken

Voraussetzungen

• uv — Installation mit curl -LsSf https://astral.sh/uv/install.sh | sh

• Ein Spotify Developer-Konto

• Eine Spotify-App mit Client ID und Client Secret

Abrufen Ihrer Spotify-Anmeldedaten

1. Gehen Sie zum Spotify Developer Dashboard

2. Klicken Sie auf Create App

3. Füllen Sie die App-Details aus:

   • App name: Wählen Sie einen beliebigen Namen (z. B. "My MCP Server")

   • App description: Optional

   • Redirect URI: http://127.0.0.1:8888/callback

   • Which API/SDKs are you planning to use?: Wählen Sie Web API

4. Klicken Sie auf Save

5. Suchen Sie auf der Seite Ihrer App nach Ihrer Client ID

6. Klicken Sie auf Show client secret, um Ihr Client Secret anzuzeigen

Wichtig: Die Redirect URI muss exakt http://127.0.0.1:8888/callback entsprechen (oder dem Wert, den Sie in SPOTIFY_REDIRECT_URI festgelegt haben). Verwenden Sie nicht localhost — verwenden Sie 127.0.0.1.

Installation

Wählen Sie unten Ihren Client aus. Alle Beispiele verwenden uvx, um den Server bei Bedarf abzurufen — kein Klonen, keine manuelle Installation.

Claude Code

claude mcp add spotify \
  -e SPOTIFY_CLIENT_ID=your_client_id \
  -e SPOTIFY_CLIENT_SECRET=your_client_secret \
  -- uvx mcp-server-spotify

Andere MCP-Clients

Die meisten MCP-Clients konfigurieren Server über eine JSON-Datei. Fügen Sie diesen Eintrag zur MCP-Konfiguration Ihres Clients hinzu:

{
  "mcpServers": {
    "spotify": {
      "command": "uvx",
      "args": ["mcp-server-spotify"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your_client_id",
        "SPOTIFY_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Ausführen aus einem lokalen Checkout

Für die Entwicklung oder wenn Sie eine modifizierte Kopie ausführen möchten:

git clone https://github.com/llyfn/spotify-mcp.git
cd spotify-mcp && uv sync

Verweisen Sie dann Ihren Client auf den lokalen Checkout anstelle von uvx:

"command": "uv",
"args": ["--directory", "/absolute/path/to/spotify-mcp", "run", "mcp-server-spotify"]

Konfiguration

Authentifizierung

Der Server verwendet den Authorization Code-Flow von Spotify:

1. Bei der ersten Verwendung öffnet der Server Ihren Browser zur Anmeldeseite von Spotify

2. Spotify bittet Sie, den Zugriff zu genehmigen — der Server fordert alle für den vollen Funktionsumfang benötigten Scopes an (Wiedergabe, Bibliothek, Playlists und Benutzerdaten)

3. Nachdem Sie autorisiert haben, leitet Spotify zum lokalen Callback-Server weiter

4. Der Server tauscht den Autorisierungscode gegen Zugriffs-/Aktualisierungstoken aus

5. Token werden sicher in ~/.spotify-mcp/credentials.json gespeichert

6. Token werden automatisch aktualisiert, wenn sie ablaufen

Wenn Sie in einer Headless-Umgebung (SSH, Docker) arbeiten, wird die Auth-URL in stderr ausgegeben — kopieren Sie diese manuell in einen Browser.

Erneute Authentifizierung

Um sich erneut zu authentifizieren (z. B. nach dem Widerruf des Zugriffs), löschen Sie die gespeicherten Anmeldedaten:

rm ~/.spotify-mcp/credentials.json

Verfügbare Werkzeuge

Suche

Alben

Künstler

Titel

Playlists

Bibliothek

Player

Shows & Podcasts

Hörbücher

Benutzer

Das Folgen von Künstlern/Benutzern verwendet dieselben save_to_library / remove_from_library / check_saved_in_library Werkzeuge — übergeben Sie eine Künstler- oder Benutzer-URI.

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung und Richtlinien.

Lizenz

MIT - siehe LICENSE für Details.