Spotify MCP-Server

Spotify-MCP MCP-Server

MCP-Projekt zur Verbindung von Claude mit Spotify. Basierend auf der API von spotipy-dev .

Merkmale

Wiedergabe starten, pausieren und überspringen
Suche nach Titeln/Alben/Interpreten/Wiedergabelisten
Informationen zu einem Titel/Album/Künstler/einer Playlist erhalten
Verwalten der Spotify-Warteschlange
Verwalten, Erstellen und Aktualisieren von Wiedergabelisten

Demo

Stellen Sie sicher, dass Sie den Ton einschalten

Konfiguration

Spotify-API-Schlüssel erhalten

Erstellen Sie ein Konto auf developer.spotify.com . Navigieren Sie zum Dashboard . Erstellen Sie eine App mit der Umleitungs-URI http://127.0.0.1:8080/callback . Sie können einen beliebigen Port wählen, müssen aber http und eine explizite Loopback-Adresse (IPv4 oder IPv6) verwenden.

Weitere Informationen/Fehlerbehebung finden Sie hier . Möglicherweise müssen Sie Ihre MCP-Umgebung (z. B. Claude Desktop) ein- oder zweimal neu starten, bevor es funktioniert.

Führen Sie dieses Projekt lokal aus

Dieses Projekt ist noch nicht für temporäre Umgebungen (z. B. uvx -Nutzung) eingerichtet. Führen Sie das Projekt lokal aus, indem Sie dieses Repo klonen.

git clone https://github.com/varunneal/spotify-mcp.git

Fügen Sie dieses Tool als MCP-Server hinzu.

Claude Desktop unter MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json

Claude Desktop unter Windows: %APPDATA%/Claude/claude_desktop_config.json

"spotify": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/spotify_mcp",
      "run",
      "spotify-mcp"
    ],
    "env": {
      "SPOTIFY_CLIENT_ID": YOUR_CLIENT_ID,
      "SPOTIFY_CLIENT_SECRET": YOUR_CLIENT_SECRET,
      "SPOTIFY_REDIRECT_URI": "http://127.0.0.1:8080/callback"
    }
  }

Fehlerbehebung

Bitte melden Sie uns, wenn Sie dieses MCP nicht zum Laufen bringen. Hier sind einige Tipps:

Stellen Sie sicher, dass uv aktualisiert ist. Ich empfehle Version >=0.54 .
Stellen Sie sicher, dass Claude über Ausführungsberechtigungen für das Projekt verfügt: chmod -R 755 .
Stellen Sie sicher, dass Sie über Spotify Premium verfügen (erforderlich zum Ausführen der Entwickler-API).

Dieses MCP gibt Protokolle an std err aus (wie in der MCP-Spezifikation angegeben). Auf dem Mac sollte die Claude Desktop-App diese Protokolle an ~/Library/Logs/Claude ausgeben. Auf anderen Plattformen finden Sie die Protokolle hier .

Sie können den MCP Inspector über npm mit diesem Befehl starten:

npx @modelcontextprotocol/inspector uv --directory /path/to/spotify_mcp run spotify-mcp

Beim Start zeigt der Inspector eine URL an, auf die Sie in Ihrem Browser zugreifen können, um mit dem Debuggen zu beginnen.

ZU TUN

Leider wurden viele nützliche Funktionen der Spotify-API verworfen . Die meisten neuen Funktionen sind eher unwichtig oder dienen dem Projekt.

Tests.
Hinzufügen von API-Unterstützung zum Verwalten von Wiedergabelisten.
Hinzufügen von API-Unterstützung für paginierte Suchergebnisse/Wiedergabelisten/Alben.

PRs geschätzt! Vielen Dank an @jamiew, @davidpadbury, @manncodes, @hyuma7, @aanurraj und andere für ihre Beiträge.

Einsatz

(alles)

Erstellen und Veröffentlichen

So bereiten Sie das Paket für die Verteilung vor:

Abhängigkeiten synchronisieren und Sperrdatei aktualisieren:

uv sync

Erstellen Sie Paketverteilungen:

uv build

Dadurch werden Quell- und Wheel-Distributionen im Verzeichnis dist/ erstellt.

Auf PyPI veröffentlichen:

uv publish

Hinweis: Sie müssen PyPI-Anmeldeinformationen über Umgebungsvariablen oder Befehlsflags festlegen:

Token: --token oder UV_PUBLISH_TOKEN
Oder Benutzername/Passwort: --username / UV_PUBLISH_USERNAME und --password / UV_PUBLISH_PASSWORD

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Verbindet Claude mit Spotify, sodass Benutzer die Wiedergabe steuern, nach Musik suchen, Titel-/Künstlerinformationen abrufen und die Warteschlange über die Spotify-API verwalten können.

Related MCP Servers

Spotify MCP Server
varunneal
A
security
F
license
A
quality
A server that connects Claude with Spotify, allowing users to control playback, search content, get information about tracks/albums/artists/playlists, and manage the Spotify queue.
Last updated -
4
273
Python
Spotify MCP Server
jamiew
A
security
F
license
A
quality
Connects Claude with Spotify, allowing users to control playback, search for content, get music information, and manage the Spotify queue.
Last updated -
8
1
Python
Spotify MCP Server
boristopalov
-
security
F
license
-
quality
Connects Claude with Spotify, enabling playback control, search functionality, and queue management through Spotify's API.
Last updated -
Python
Spotify MCP Server
Naunau75
-
security
F
license
-
quality
Connects Claude with Spotify to control playback, search music, get track information, and manage the queue through conversation.
Last updated -
Python

View all related MCP servers

Spotify MCP Server