Android TV远程控制协议

MCP(模型上下文协议)服务器直接在Android TV设备上运行,通过ADB(Android调试桥)实现本地网络控制,支持通过自然语言操作电视应用。

  • by MiddlePoint-Solutions
  • Kotlin
  • 本地部署
  • 23 星标
  • 更新于
在 GitHub 查看 MiddlePoint-Solutions/mcp-on-android-tv

使用说明

Android TV上的MCP(可能指某种应用、服务或功能模块,具体需根据上下文确定,此处直译为“Android TV上的MCP”)

一个直接在您的Android TV设备上运行的模型上下文协议(MCP)服务器。

通过利用ADB(Android调试桥),它允许您通过任何支持远程MCP服务器的LLM代理或客户端对您的Android TV进行本地网络控制。这使得您能够使用自然语言在电视上打开应用、列出应用以及执行其他命令。

⚠️ 进行中的工作/未完成的工作
这个项目尚处于开发初期。功能可能不完整、不稳定或会有所变动。
随着项目的推进,非常欢迎贡献和反馈。

为什么选择Android TV?

  • 更简单的ADB设置在Android TV上,可以激活ADB调试并连接,无需配对。
  • 稳定的本地连接与手机上的无线调试不同,该连接不会循环,而是为您提供与设备的直接链接。
  • MCP集成随着MCP(可能指某种通信协议或中间件)被叠加在ADB(可能指某种数据库或应用平台)之上,任何支持自定义MCP服务器的LLM(大型语言模型)客户端(例如 鹅 或者 Claude Desktop(可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”)) 可以作为您电视的遥控器。

⚠️(注意/警告) 注出于安全考虑,这应该仅在您的本地网络上运行,将电视暴露在互联网上存在很大的风险。

特点/功能

  • 直接 亚洲开发银行(ADB)的整合 无需配对。
  • 在Android TV设备上运行的MCP服务器。
  • 与……配合使用 MCP Kotlin SDK 0.7.2 (官方SDK)。
  • 通过LLM客户端控制本地网络设备。
  • 当前的沟通方式: SSE(已弃用)。

暴露的MCP工具

MCP服务器目前支持以下工具:

  • [x] 启动电视应用 — 通过包名启动一个电视应用程序。
  • [x] 获取已安装的电视应用 — 获取已安装的电视应用程序列表。
  • [x] 截取屏幕截图 — 截取设备屏幕的截图。
  • [x] 发送按键事件 — 向设备发送一个按键事件。
  • [x] 发送导航键事件 — 发送导航按键事件(上、下、左、右、选择、返回、主页)。
  • [x] 文本类型 — 在当前输入框中输入文本。
  • [x] 触摸屏幕 — 在特定坐标处轻触屏幕。

安装与使用

  1. 构建并安装 在您的Android电视设备或机顶盒上安装该应用。
  2. 确保 ADB调试 已启用并正常工作。
  3. 启动应用程序——它将显示 MCP 准备就绪 使用以下内容进行屏幕(操作/展示):
    • 设备详情
    • 要连接的MCP服务器地址
  4. 在您的大型语言模型(LLM)客户端上(例如,Goose、Claude Desktop):
    • 创建一个新的连接器/扩展。
    • 在电视上输入服务器地址。
  5. 开始使用自然语言控制您的电视:
    • 打开应用程序
    • 列出已安装的应用程序
    • 更多命令即将推出

做出贡献

非常欢迎您的贡献!

  • 提交一份 拉取请求(或合并请求) 带有新功能、工具或修复程序。
  • 鼓励提出扩展控制和实用程序的想法。
  • 在提交更改时,请遵循典型的开源礼仪。

许可证

这个项目采用MIT许可证授权——详见 许可证 文件中有详细信息。