Samsung Stremio Spotify MCP

Ihr persönlicher Assistent für das Samsung TV

Sagen Sie ihm, was Sie sehen möchten. Er findet die richtige Folge, startet sie auf Ihrem Fernseher, merkt sich, wo Sie aufgehört haben, und hält Ihren Abend in Bewegung.

Sie können natürlich fragen:

„Welche neuen Folgen kann ich ansehen?“

„Setze die Serie fort, die ich gesehen habe.“

„Erstelle mir eine Warteschlange mit diesen drei Folgen, in dieser Reihenfolge.“

„Stoppe nach dieser Folge.“

Das Projekt bringt Ihre Stremio-Bibliothek, Samsung TV, Spotify und optional den Trakt-Verlauf in ein Gespräch. Sie entscheiden, was Sie sehen oder hören möchten; der Assistent kümmert sich um die Schritte rundherum.

Related MCP server: Arr Suite MCP Server

Was sich beim Fernsehen ändert

Hinsetzen und weitermachen

Sie müssen sich nicht an Staffel, Folge oder Zeitstempel erinnern. Bitten Sie darum, eine Serie fortzusetzen, und der Assistent kann eine teilweise gesehene Folge fortsetzen oder die nächste ungesehene vorschlagen.

Wissen, was tatsächlich bereit zum Ansehen ist

Fragen Sie nach Neuem und erhalten Sie veröffentlichte, ungesehene Folgen aus Ihrer eigenen Bibliothek, die derzeit eine abspielbare Quelle haben. Die Antwort bezieht sich darauf, was Sie jetzt ansehen können, nicht nur darauf, was in einem Veröffentlichungskalender erschienen ist.

Einen ganzen Abend in einem Satz planen

Erstellen Sie eine manuell geordnete Warteschlange aus verschiedenen Serien. Wählen Sie, was zuerst läuft, was folgt und wo der Abend endet. Die Warteschlange wird lokal gespeichert und rückt vor, wenn Folgen enden.

Einem Binge natürlich freien Lauf lassen

Wenn Sie ausdrücklich darum bitten, eine Serie zu bingen, kann die nächste ungesehene Folge automatisch beginnen. Wenn Sie „Stoppe nach dieser Folge“ sagen oder den Fernseher ausschalten, respektiert der Assistent diese Grenze.

Einen guten Stream bekommen, ohne Release-Namen zu studieren

Der Assistent berücksichtigt Verfügbarkeit, Qualität, Dateigröße, Video- und Audiokompatibilität, Seed-Gesundheit, Sprache und Untertitelhinweise. Er validiert die ausgewählte Quelle und kann einen anderen Kandidaten versuchen, wenn einer fehlschlägt.

Ihren Sehverlauf nützlich halten

Der tatsächliche Wiedergabefortschritt vom Fernseher wird zurück zu Stremio gespeichert. Teilweise gesehene Folgen können später fortgesetzt werden, und abgeschlossene Folgen werden bei der normalen Abschlussschwelle als gesehen markiert. Trakt-Scrobbling kann hinzugefügt werden, ohne dass es für die Wiedergabe erforderlich ist.

Den Rest des Raums steuern

Dasselbe Gespräch kann Spotify auf dem Fernseher öffnen, Musik finden, eine Künstler-Warteschlange aufbauen, ohne den aktuellen Song zu unterbrechen, die Wiedergabe steuern oder die Lautstärke des Fernsehers einstellen.

Ein typischer Abend

1. Fragen Sie: „Welche neuen Folgen kann ich ansehen?“

2. Wählen Sie eine Folge oder ordnen Sie mehrere Serien in einer Warteschlange an.

3. Der Assistent findet eine kompatible Quelle und startet sie auf dem Samsung TV.

4. Der Wiedergabefortschritt wird überwacht, während Sie zusehen.

5. Wenn Sie früh stoppen, wird Ihre Position gespeichert. Wenn Sie fertig sind, wird Ihr Sehstatus aktualisiert.

6. Im Binge- oder Warteschlangenmodus läuft der Abend gemäß der von Ihnen gewählten Reihenfolge weiter.

Dinge, die Sie fragen können

• Play season [season] episode [episode] of [show].

• Continue the show I was watching.

• Binge this show.

• Stop after this episode.

• Create a queue with these episodes, in this order.

• Skip this queue item.

• What new episodes can I watch?

• Mark the episode I just finished as watched.

• Play songs by [artist] without interrupting the current song.

• Set the TV volume to [level].

Auf Ihre Entscheidungen zugeschnitten

Die Integrationen sind unabhängig:

• Verwenden Sie Stremio ohne Spotify oder Trakt.

• Verwenden Sie Spotify, ohne Stremio zu verbinden.

• Fügen Sie Trakt nur hinzu, wenn Sie Scrobbling möchten.

• Verwenden Sie TV-Steuerung, ohne ein Medienkonto zu konfigurieren.

Anmeldeinformationen, Wiedergabestatus, Warteschlangen und Pairing-Informationen bleiben auf Ihrem Computer. Der HTTP-Dienst und das lokale Stremio-Addon lauschen nur auf dem lokalen Rechner.

Aktuelle Unterstützung

Samsung bleibt der universelle Fallback und behält seine nativen Strom-, Lautstärke-, App-Start-, DLNA-Wiedergabe- und Telemetriesteuerungen. Gespeicherte Google-Cast-Empfänger wie Cellcom Master Boxes können ebenfalls explizit ausgewählt oder als Standard für einen Netzwerk-Fingerabdruck festgelegt werden.

Die Zielpriorität ist:

1. Ein explizites target in einer Stremio-Wiedergabeanfrage.

2. Das gespeicherte Ziel für den aktuellen Netzwerk-Fingerabdruck.

3. Samsung.

Netzwerkzuordnungen und Empfängeridentitäten befinden sich im lokalen Zustandsverzeichnis als media-devices.json; sie werden nicht in das Projekt übernommen.

Spotify und Trakt sind optional. Die Stremio-Wiedergabe erfordert ein verknüpftes Stremio-Konto, geeignete Stream-Addons und ein erreichbares Samsung TV.

Anforderungen

• Node.js 20 oder neuer

• Ein Samsung Smart TV, der aus demselben lokalen Netzwerk erreichbar ist

• Eine funktionierende lokale SamsungTVControl-Installation für Pairing, Strom und Fernbedienungstasten

• Stremio mit den gewünschten Stream-Addons installiert

• Eine Spotify-Developer-Anwendung für Spotify-Funktionen

• Eine Trakt-API-Anwendung für optionales Scrobbling

Installieren

git clone https://github.com/dudibuilds/samsung-stremio-spotify-mcp.git
cd samsung-stremio-spotify-mcp
npm install
npm run init-config

Lokale Anmeldeinformationen und Zustand werden erstellt unter:

%USERPROFILE%\.samsung-spotify-tv\

Der alte Verzeichnisname wird beibehalten, damit bestehende Installationen weiter funktionieren.

Einen MCP-Client verbinden

Der Server verwendet standardmäßig stdio. Weisen Sie den MCP-Client auf den absoluten Pfad von server/index.mjs:

{
  "mcpServers": {
    "samsung-stremio-spotify": {
      "command": "node",
      "args": [
        "C:\\absolute\\path\\to\\samsung-stremio-spotify-mcp\\server\\index.mjs"
      ]
    }
  }
}

Starten Sie den MCP-Client nach einer Änderung seiner Konfiguration neu.

Stremio verknüpfen

1. Rufen Sie integration_auth mit provider: "stremio" und action: "start" auf.

2. Öffnen und genehmigen Sie den zurückgegebenen Link.

3. Rufen Sie integration_auth mit provider: "stremio" und action: "complete" auf.

Spotify verbinden

1. Erstellen Sie eine Spotify-Developer-Anwendung.

2. Fügen Sie http://127.0.0.1:18765/callback als Redirect-URI hinzu.

3. Füllen Sie %USERPROFILE%\.samsung-spotify-tv\spotify-credentials.json aus.

4. Führen Sie npm run auth aus.

Trakt verbinden (optional)

1. Erstellen Sie eine Trakt-API-Anwendung.

2. Füllen Sie %USERPROFILE%\.samsung-spotify-tv\trakt-credentials.json aus.

3. Rufen Sie integration_auth mit provider: "trakt" und action: "start" auf.

4. Genehmigen Sie den angezeigten Code und verwenden Sie dann action: "complete".

Den optionalen HTTP-Dienst ausführen

npm run mcp:http

Der MCP-Endpunkt ist http://127.0.0.1:4512/mcp.

Das lokale Cast to TV-Addon installieren

Wenn der HTTP-Dienst läuft, installieren Sie diese URL in Desktop-Stremio:

http://127.0.0.1:4512/stremio-cast/manifest.json

Dies fügt Cast to TV-Optionen in Stremio hinzu. Die automatische Option verwendet die aktuelle Netzwerkzuordnung und fällt dann auf Samsung zurück; benannte Samsung- und Google-Cast-Ziele werden ebenfalls explizit aufgelistet.

Umgebungsüberschreibungen

Siehe .env.example für optionale Pfad-, Gerätename-, Stremio-Server-, Host- und Port-Überschreibungen. Platzieren Sie niemals echte Anmeldeinformationen in .env.example oder übernehmen Sie eine gefüllte Umgebungsdatei in das Repository.

Version 0.2.1 stellt neun domänenorientierte Tools bereit:

Jede Aktion validiert nur die für diese Aktion relevanten Parameter. Fehler enthalten tool, action, code und message.

Migration zu Version 0.2

Version 0.2 ist ein harter Tool-API-Wechsel. stremio_queue behält seinen Namen und Vertrag. stremio_library behält seinen Namen, erfordert jetzt jedoch eine Mutationsaktion; die Bibliotheksliste wurde zu stremio_discover verschoben. Andere Toolnamen aus 0.1 werden nicht mehr beworben oder akzeptiert.

Wiedergabeverhalten

• Explizite Staffel- und Folgenanfragen werden sofort abgespielt.

• Bloße Serientitel schlagen vor, fortzusetzen oder die nächste ungesehene Folge zu starten.

• Die Wiedergabe wird bei 90 % Abschluss als gesehen markiert.

• Warteschlangenzustand und Teilfortschritt werden lokal gespeichert.

• Das Ausschalten des Fernsehers schließt die Sitzung ab und stoppt das automatische Fortschreiten.

• Fehlgeschlagene Quellen ermöglichen den Versuch des nächsten eingestuften Kandidaten.

Hauptkomponenten

Validierung

npm run smoke
npm run mcp:smoke
npm audit --omit=dev

Tests verwenden temporären Zustand und blockieren Live-TV und externen Netzwerkzugriff.

Sicherheit

Diese Software steuert einen physischen Fernseher und verwendet authentifizierte Medienkonten. Halten Sie Anmeldeinformationen, Pairing-Tokens, Laufzeitzustand und Protokolle aus Git heraus. Setzen Sie den HTTP-MCP oder das lokale Addon nicht dem LAN oder Internet aus. Siehe SECURITY.md.

Lizenz

MIT. Siehe LICENSE.