TIDAL MCP: My Custom Picks

TIDAL MCP: Meine benutzerdefinierten Empfehlungen 🌟🎧

Die meisten Musikplattformen bieten Empfehlungen – täglich neu entdeckte Songs, Top-Künstler, Neuzugänge usw. –, aber selbst mit dem modernsten System wirken diese oft zu „aggregiert“. Ich wollte etwas Individuelleres und Kontextbezogeneres.

Mit TIDAL MCP können Sie Dinge anfordern wie:

„Basierend auf meinen letzten 10 Favoriten, finde ähnliche Titel – aber nur solche aus den letzten Jahren.“

„Finde für mich Titel wie die in dieser Playlist, aber langsamer und akustischer.“

Das LLM filtert und kuratiert Ergebnisse anhand Ihrer Eingaben, findet ähnliche Titel über die API von TIDAL und erstellt neue Wiedergabelisten direkt in Ihrem Konto.

Merkmale

• 🌟 Musikempfehlungen : Erhalten Sie personalisierte Titelempfehlungen basierend auf Ihrem Hörverlauf und Ihren benutzerdefinierten Kriterien .
• ၊၊||၊ Playlist-Verwaltung : Erstellen, Anzeigen und Verwalten Ihrer TIDAL-Playlists

Schnellstart

Voraussetzungen

• Python 3.10+
• uv (Python-Paketmanager)
• TIDAL-Abonnement

Installation

1. Klonen Sie dieses Repository:
   git clone https://github.com/yuhuacheng/tidal-mcp.git cd tidal-mcp
2. Erstellen Sie eine virtuelle Umgebung und installieren Sie Abhängigkeiten mit uv:
   uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
3. Installieren Sie das Paket mit allen Abhängigkeiten aus der Datei pyproject.toml:
   uv pip install --editable .
   Dadurch werden alle in der Datei pyproject.toml definierten Abhängigkeiten installiert und das Projekt im Entwicklungsmodus eingerichtet.

MCP-Client-Konfiguration

Claude Desktop-Konfiguration

Um diesen MCP-Server zu Claude Desktop hinzuzufügen, müssen Sie die MCP-Konfigurationsdatei aktualisieren. Hier ist eine Beispielkonfiguration: (Sie können den Port angeben, indem Sie einen optionalen env mit der Umgebungsvariable TIDAL_MCP_PORT hinzufügen.)

Beispiel-Screenshot der MCP-Konfiguration in Claude Desktop:

Schritte zum Installieren der MCP-Konfiguration

1. Öffnen Sie Claude Desktop
2. Gehen Sie zu Einstellungen > Entwickler
3. Klicken Sie auf „Konfiguration bearbeiten“
4. Fügen Sie die geänderte JSON-Konfiguration ein
5. Speichern der Konfiguration
6. Starten Sie Claude Desktop neu

Vorgeschlagene Eingabeaufforderungsstarter

Nach der Konfiguration können Sie über ein LLM mit Ihrem TIDAL-Konto interagieren, indem Sie Fragen stellen wie:

• „Empfehle Songs wie die in dieser Playlist, aber langsamer und akustischer.“
• „Erstelle eine Playlist basierend auf meinen Top-Tracks, aber mit Fokus auf entspannter Late-Night-Stimmung.“
• „Finden Sie Songs wie diese in der Playlist XYZ, aber in anderen Sprachen als Englisch.“

💡 Sie können das Modell auch bitten:

• Verwenden Sie mehrere Titel als Ausgangspunkt, um die Inspiration zu erweitern.
• Geben Sie weitere Empfehlungen zurück, wenn Sie eine längere Playlist wünschen.
• Oder löschen Sie eine Playlist, wenn sie Ihnen nicht gefällt – kein Druck!

Verfügbare Tools

Die TIDAL MCP-Integration bietet die folgenden Tools:

• tidal_login : Authentifizieren Sie sich mit TIDAL über den Browser-Anmeldefluss
• get_favorite_tracks : Rufen Sie Ihre Lieblingstitel von TIDAL ab
• recommend_tracks : Erhalten Sie personalisierte Musikempfehlungen
• create_tidal_playlist : Erstellen Sie eine neue Playlist in Ihrem TIDAL-Konto
• get_user_playlists : Listet alle Ihre Wiedergabelisten auf TIDAL auf
• get_playlist_tracks : Ruft alle Titel aus einer bestimmten Playlist ab
• delete_tidal_playlist : Löschen Sie eine Playlist aus Ihrem TIDAL-Konto

Lizenz

MIT-Lizenz

Danksagung

• Modellkontextprotokoll (MCP)
• TIDAL Python API