Samsung Stremio Spotify MCP

Samsung TV のためのパーソナル視聴アシスタント

見たいものを伝えると、適切なエピソードを見つけ、テレビで再生を開始し、停止した場所を記憶し、夜の流れを維持します。

自然に尋ねることができます：

「新しいエピソードは何が見られますか？」 「見ていた番組を続けて。」 「この3つのエピソードをこの順番でキューに入れて。」 「このエピソードの後に停止して。」

このプロジェクトは、Stremio ライブラリ、Samsung TV、Spotify、オプションの Trakt 履歴を1つの会話にまとめます。何を見るか、何を聴くかを決めるのはあなたです。アシスタントがその周りの手順を処理します。

Related MCP server: Arr Suite MCP Server

テレビ視聴がどう変わるか

座って続きから

シーズン、エピソード、タイムスタンプを覚えておく必要はありません。番組の続きを頼むと、アシスタントは途中まで見たエピソードを再開したり、次の未視聴エピソードを提案したりできます。

実際に視聴可能なものを把握

新着を尋ねると、自分のライブラリから、現在再生可能なソースがある公開済みの未視聴エピソードを取得できます。答えは、リリースカレンダーに載ったものだけでなく、今すぐ視聴できるものについてです。

一文で夜の計画を立てる

異なる番組から手動で順序付けされたキューを作成します。最初に何を再生するか、次に何を再生するか、夜の終わりを決めます。キューはローカルに保存され、エピソードが終了するたびに進行します。

一気見を自然に流す

番組を一気見するよう明示的に頼むと、次の未視聴エピソードが自動的に開始されます。「このエピソードの後に停止」と言うか、テレビの電源を切ると、アシスタントはその境界を尊重します。

リリース名を調べずに良いストリームを得る

アシスタントは、可用性、品質、ファイルサイズ、ビデオとオーディオの互換性、シードの健全性、言語、字幕のヒントを考慮します。選択したソースを検証し、失敗した場合は別の候補を試すことができます。

視聴履歴を役立つものに保つ

テレビからの実際の再生進行状況は Stremio に保存されます。途中までのエピソードは後で再開でき、完了したエピソードは通常の完了しきい値で視聴済みとしてマークされます。Trakt のスクロブリングは、再生の必須条件にせずに追加できます。

部屋の他のものを制御

同じ会話で、テレビで Spotify を開いたり、音楽を探したり、現在の曲を中断せずにアーティストキューを作成したり、再生を制御したり、テレビの音量を設定したりできます。

典型的な夜

1. 「新しいエピソードは何が見られますか？」と尋ねます。

2. 1つのエピソードを選ぶか、複数の番組をキューにまとめます。

3. アシスタントが互換性のあるソースを見つけ、Samsung TV で再生を開始します。

4. 視聴中は再生進行状況が監視されます。

5. 早めに停止した場合は、位置が保存されます。最後まで見た場合は、視聴状態が更新されます。

6. 一気見モードまたはキューモードでは、選択した順序に従って夜が続きます。

尋ねられること

• 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].

あなたの選択を中心に構築

• Stremio を Spotify や Trakt なしで使用。

• Stremio を接続せずに Spotify を使用。

• スクロブリングが必要な場合のみ Trakt を追加。

• メディアアカウントを設定せずに TV コントロールを使用。

認証情報、再生状態、キュー、ペアリング情報はコンピューター上に保持されます。HTTP サービスとローカル Stremio アドオンは、ローカルマシン上でのみリッスンします。

現在のサポート

Samsung は普遍的なフォールバックとして残り、ネイティブの電源、音量、アプリ起動、DLNA 再生、テレメトリ制御を維持します。Cellcom Master Box などの保存された Google Cast レシーバーも、明示的に選択したり、1つのネットワークフィンガープリントのデフォルトとして割り当てたりできます。

ターゲットの優先順位は次のとおりです：

1. Stremio 再生リクエストの明示的な target。

2. 現在のネットワークフィンガープリントの保存されたターゲット。

3. Samsung。

ネットワークマッピングとレシーバー ID は、ローカル状態ディレクトリの media-devices.json に保存されます。プロジェクトにはコミットされません。

Spotify と Trakt はオプションです。Stremio の再生には、リンクされた Stremio アカウント、適切なストリームアドオン、および到達可能な Samsung TV が必要です。

要件

• Node.js 20 以降

• 同じローカルネットワークから到達可能な Samsung スマート TV

• ペアリング、電源、リモートキー用の動作するローカル SamsungTVControl インストール

• 必要なストリームアドオンがインストールされた Stremio

• Spotify 機能用の Spotify Developer アプリケーション

• オプションのスクロブリング用の Trakt API アプリケーション

インストール

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

ローカル認証情報と状態は次の場所に作成されます：

%USERPROFILE%\.samsung-spotify-tv\

既存のインストールが引き続き動作するように、レガシーディレクトリ名が保持されています。

MCP クライアントを接続

サーバーはデフォルトで stdio を使用します。MCP クライアントを server/index.mjs の絶対パスに指定します：

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

設定を変更した後、MCP クライアントを再起動します。

Stremio をリンク

1. integration_auth を provider: "stremio" と action: "start" で呼び出します。

2. 返されたリンクを開いて承認します。

3. integration_auth を provider: "stremio" と action: "complete" で呼び出します。

Spotify を接続

1. Spotify Developer アプリケーションを作成します。

2. リダイレクト URI として http://127.0.0.1:18765/callback を追加します。

3. %USERPROFILE%\.samsung-spotify-tv\spotify-credentials.json を入力します。

4. npm run auth を実行します。

Trakt を接続（オプション）

1. Trakt API アプリケーションを作成します。

2. %USERPROFILE%\.samsung-spotify-tv\trakt-credentials.json を入力します。

3. integration_auth を provider: "trakt" と action: "start" で呼び出します。

4. 表示されたコードを承認し、action: "complete" を使用します。

オプションの HTTP サービスを実行

npm run mcp:http

MCP エンドポイントは http://127.0.0.1:4512/mcp です。

ローカルの Cast to TV アドオンをインストール

HTTP サービスを実行した状態で、デスクトップ Stremio にこの URL をインストールします：

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

これにより、Stremio 内に Cast to TV の選択肢が追加されます。自動選択は現在のネットワークマッピングを使用し、次に Samsung にフォールバックします。名前付きの Samsung と Google Cast ターゲットも明示的にリストされます。

環境変数の上書き

オプションのパス、デバイス名、Stremio サーバー、ホスト、ポートの上書きについては .env.example を参照してください。実際の認証情報を .env.example に置いたり、入力済みの環境ファイルをコミットしたりしないでください。

バージョン 0.2.1 は、9つのドメイン指向ツールを公開しています：

各アクションは、そのアクションに関連するパラメータのみを検証します。エラーには tool、action、code、message が含まれます。

バージョン 0.2 移行

バージョン 0.2 は、ツール API のハードカットオーバーです。stremio_queue は名前と契約を維持します。stremio_library は名前を維持しますが、ミューテーションアクションが必要になりました。ライブラリの一覧は stremio_discover に移動しました。他の 0.1 ツール名は、宣伝も受け付けもされなくなりました。

再生動作

• 明示的なシーズンとエピソードのリクエストはすぐに再生されます。

• シリーズ名のみの場合は、再開または次の未視聴エピソードの開始を提案します。

• 再生は 90% 完了で視聴済みとしてマークされます。

• キューの状態と部分的な進行状況はローカルに永続化されます。

• テレビの電源を切ると、セッションが終了し、自動進行が停止します。

• 失敗したソースでは、次のランク付けされた候補を試すことができます。

主要コンポーネント

検証

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

テストは一時的な状態を使用し、ライブ TV と外部ネットワークアクセスをブロックします。

セキュリティ

このソフトウェアは物理的なテレビを制御し、認証されたメディアアカウントを使用します。認証情報、ペアリングトークン、ランタイム状態、ログを Git に含めないでください。HTTP MCP やローカルアドオンを LAN やインターネットに公開しないでください。SECURITY.md を参照してください。

ライセンス

MIT。LICENSE を参照してください。