Samsung Stremio Spotify MCP

您的三星电视个人观影助手

告诉它您想看什么。它会找到正确的剧集，在您的电视上播放，记住您停下的位置，并让您的夜晚继续。

您可以自然地提问：

“有什么新剧集可以看？”

“继续我上次看的节目。”

“按这个顺序给我排这三集。”

“这集播完就停。”

该项目将您的 Stremio 库、三星电视、Spotify 和可选的 Trakt 历史整合到一次对话中。您决定想看或想听什么；助手负责处理围绕它的步骤。

Related MCP server: Arr Suite MCP Server

它如何改变看电视的方式

坐下继续

您无需记住季数、集数或时间戳。要求继续某个节目，助手可以恢复部分观看的剧集或建议下一集未观看的剧集。

知道实际可以看什么

询问有什么新内容，即可从您自己的库中获取已发布、未观看且当前有可播放源的剧集。答案是关于您现在可以看什么，而不仅仅是发布日历上出现了什么。

一句话规划整个夜晚

从不同节目创建手动排序的队列。选择先播放什么、接下来是什么以及夜晚在哪里结束。队列保存在本地，并随着剧集结束而推进。

让追剧自然流畅

当您明确要求追剧时，下一集未观看的剧集可以自动开始。如果您说“这集播完就停”或关闭电视，助手会尊重这个边界。

无需研究发布名称即可获得好的流

助手会考虑可用性、质量、文件大小、视频和音频兼容性、种子健康度、语言和字幕提示。它会验证所选源，并在失败时尝试另一个候选源。

保持您的观看历史有用

来自电视的真实播放进度会保存回 Stremio。部分观看的剧集可以稍后恢复，已完成的剧集在正常完成阈值处标记为已观看。可以添加 Trakt 记录，而无需将其作为播放的要求。

控制房间的其他部分

同一对话可以在电视上打开 Spotify、查找音乐、在不中断当前歌曲的情况下构建艺术家队列、控制播放或设置电视音量。

一个典型的夜晚

1. 问：“有什么新剧集可以看？”

2. 选择一集或将多个节目排列成队列。

3. 助手找到兼容的源并在三星电视上开始播放。

4. 观看时监控播放进度。

5. 如果您提前停止，您的位置会被保存。如果您看完，您的观看状态会更新。

6. 在追剧或队列模式下，夜晚会根据您选择的顺序继续。

您可以问的事情

• 播放 [节目] 的第 [季] 季第 [集] 集。

• 继续我上次看的节目。

• 追这部剧。

• 这集播完就停。

• 按这个顺序创建包含这些剧集的队列。

• 跳过这个队列项。

• 有什么新剧集可以看？

• 把我刚看完的这集标记为已观看。

• 播放 [艺术家] 的歌曲，不要打断当前歌曲。

• 将电视音量设置为 [级别]。

围绕您的选择构建

这些集成是独立的：

• 使用 Stremio 而不使用 Spotify 或 Trakt。

• 使用 Spotify 而不连接 Stremio。

• 仅在需要记录时添加 Trakt。

• 使用电视控制而无需配置媒体账户。

凭据、播放状态、队列和配对信息保留在您的计算机上。HTTP 服务和本地 Stremio 插件仅监听本地机器。

当前支持

三星仍然是通用后备方案，并保留其原生电源、音量、应用启动、DLNA 播放和遥测控制。已保存的 Google Cast 接收器（如 Cellcom Master Boxes）也可以显式选择或分配为某个网络指纹的默认值。

目标优先级为：

1. Stremio 播放请求上的显式 target。

2. 当前网络指纹的已保存目标。

3. 三星。

网络映射和接收器身份存储在本地状态目录中的 media-devices.json 中；它们不会提交到项目。

Spotify 和 Trakt 是可选的。Stremio 播放需要关联的 Stremio 账户、合适的流插件和可访问的三星电视。

要求

• Node.js 20 或更高版本

• 可从同一本地网络访问的三星智能电视

• 可用的本地 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. 添加 http://127.0.0.1:18765/callback 作为重定向 URI。

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 中添加 投射到电视 选项。自动选项使用当前网络映射，然后回退到三星；命名三星和 Google Cast 目标也会显式列出。

环境覆盖

参见 .env.example 了解可选路径、设备名称、Stremio 服务器、主机和端口覆盖。切勿将真实凭据放入 .env.example 或提交包含环境变量的文件。

版本 0.2.1 公开了九个面向领域的工具：

每个操作仅验证与该操作相关的参数。错误包含 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

测试使用临时状态，并阻止实时电视和外部网络访问。

安全

本软件控制物理电视并使用经过认证的媒体账户。将凭据、配对令牌、运行时状态和日志保留在 Git 之外。不要将 HTTP MCP 或本地插件暴露到局域网或互联网。参见 SECURITY.md。

许可证

MIT。参见 LICENSE。