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

Related MCP server: Spotify MCP Server

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.

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

Fehlerbehebung

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

1. Stellen Sie sicher, dass uv aktualisiert ist. Ich empfehle Version >=0.54 .

2. Stellen Sie sicher, dass Claude über Ausführungsberechtigungen für das Projekt verfügt: chmod -R 755 .

3. 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:

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:

1. Abhängigkeiten synchronisieren und Sperrdatei aktualisieren:

2. Erstellen Sie Paketverteilungen:

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

3. Auf PyPI veröffentlichen:

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