TVWizard

TVWizard

随时随地，用任意 AI 控制你的电视。
为 Android TV 和 Google TV 提供云中继 + MCP 服务。

网站 · 价格 · 下载桥接程序 · 快速入门 · 工具参考

---

项目简介

TVWizard 可将任何兼容 Claude 的 AI 聊天变成通用遥控器。只需用 6 位代码配对一次 Android TV 或 Google TV，从那一刻起，你就可以在手机、笔记本电脑、汽车上，或任何能与 Claude 对话的地方，说“播放《Scrubs》第 2 季第 5 集”或“关闭卧室电视”。

它通过 Model Context Protocol 工作。这是一个新兴标准，旨在让 AI Agent 控制现实世界中的工具。

工作原理

  ┌───────────┐       ┌─────────────────┐       ┌─────────────────────┐
  │  Claude   │──MCP─▶│  TVWizard Relay │──WS──▶│  TVWizard Bridge    │
  │  (any)    │       │ tv.djwizard.ai  │       │  (Android TV app)   │
  └───────────┘       └─────────────────┘       └─────────────────────┘
        ▲                                                  │
        └───────── pairing code (6 digits) ────────────────┘

桥接程序会主动连接到中继服务——无需端口转发、无需 VPN，也不要求连接同一 Wi-Fi。即使你身在国外，家中的电视也能响应手机发出的命令。

安装（5 分钟）

1. 获取桥接程序 APK，请从最新版本下载。在 Android TV 或 Google TV 上安装。（侧载说明见 docs/install-bridge.md。）
2. 打开应用并点击 Pair。 电视上会显示一个 6 位代码。
3. 访问 tv.djwizard.ai/claim.html，输入代码并选择设备名称（例如 living-room）。复制生成的 Bearer 令牌和 Claude Desktop 配置片段。
4. 将其粘贴到 Claude Desktop 中（参见 docs/claude-desktop.md）。重启应用。
5. 与电视对话。 试试：“现在我的 living-room 电视上在播放什么？”或“播放《怪奇物语》第 1 季第 1 集。”

MCP 工具

工具	说明
tv.list_devices	列出已与账户配对的电视。
tv.send_key	发送按键：POWER、HOME、UP/DOWN/LEFT/RIGHT、OK、BACK、VOL_UP/DOWN。
tv.launch_app	打开 Android Intent——YouTube 深层链接、Netflix 影视内容或任意 HTTPS URL。
tv.list_apps	列出已安装的应用，让 AI 了解可用内容。
tv.play_title	通过 TMDB + JustWatch，将“Scrubs S2E5”解析为特定国家/地区的服务商深层链接（Netflix、Disney+、Max、Apple TV+ 等）。
tv.observe	读取电视屏幕状态：前台应用、当前聚焦元素、可见的可点击节点。

完整参考和示例见：docs/mcp-tools.md。

支持的服务商

tv.play_title 会通过 TMDB → JustWatch → 区域适配的 Android 包映射解析影视内容，并缓存 60 天。流媒体目录因国家/地区而异；如果 JustWatch 的覆盖不完整，Stremio（虚拟、按 IMDB 键控）可填补空缺。

类别	服务商
订阅服务	Netflix、Disney+（适配 MEA）、Prime Video、Max、Hulu、Apple TV+、Paramount+、Peacock、fuboTV
免费 / 广告支持	YouTube
虚拟（按 IMDB 键控）	Stremio

价格

抢先体验期间免费。价格方案最终确定后将在 tv.djwizard.ai/pricing.html 发布。

隐私与信任

• 开源桥接程序。你可以审查电视上运行的具体内容。
• 托管在法兰克福（欧盟），符合 GDPR 要求。隐私政策。
• 不会记录你的命令内容，不会出售，也不会用于训练任何模型。
• 发生故障时会明确报错——如果电视离线，AI 会立即收到错误，而不是收到排队等待执行的幽灵命令。

状态

• 中继服务：已在 tv.djwizard.ai 上线。运行时间：stats.uptimerobot.com。
• v0.3.0（2026 年 4 月）：六个 MCP 工具、完整的影视内容解析链、公开配对流程。参见 CHANGELOG.md。
• v0.4（下一版本）：Samsung Tizen 桥接程序、多家庭用户账户、Claude.ai 原生连接器注册。

支持

• Bug / 问题：提交问题
• 一般咨询：[email protected]
• 安全问题：[email protected]（参见 SECURITY.md）
• 商务 / 酒店：[email protected]

许可证

此仓库中的文档采用 MIT 许可证。桥接 APK 采用 Apache 2.0 许可证（源码：即将推出）。中继服务源码可用，但仅限非商业用途。