在Android TV上的MCP

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

通过利用ADB（Android调试桥），它允许通过支持远程MCP服务器的任何大型语言模型（LLM）代理或客户端来控制本地网络中的Android TV。这使得可以通过自然语言打开应用、列出应用并执行其他命令。

⚠️ 正在进行中
此项目处于早期开发阶段。功能可能不完整、不稳定或有变更。
随着项目的进展，欢迎贡献和反馈。

为什么是Android TV？

• 更简单的ADB设置：在Android TV上，可以激活ADB调试并连接，而无需配对。
• 稳定的本地连接：与手机上的无线调试不同，连接不会循环，为您提供与设备的直接链接。
• MCP集成：通过在ADB之上添加MCP层，任何支持自定义MCP服务器的LLM客户端（如Goose或Claude Desktop）都可以作为您电视的控制器。

⚠️ 注意：出于安全原因，这应该仅在本地网络中工作，将电视暴露到互联网是一个很大的风险。

功能

• 直接ADB集成，无需配对。
• 运行在Android TV设备上的MCP服务器。
• 支持MCP Kotlin SDK 0.7.2（官方SDK）。
• 通过LLM客户端进行本地网络设备控制。
• 当前通信方法：SSE（已弃用）。

暴露的MCP工具

当前的MCP服务器支持以下工具：

• 启动电视应用 — 通过包名启动电视应用。
• 获取已安装的电视应用 — 获取已安装电视应用的列表。
• 截屏 — 截取设备屏幕的截图。
• 发送按键事件 — 向设备发送按键事件。
• 发送导航键事件 — 发送导航键事件（上、下、左、右、选择、返回、主页）。
• 输入文本 — 将文本输入当前输入字段。
• 点击屏幕 — 在特定坐标处点击屏幕。

安装及使用

1. 构建并安装应用程序到您的Android TV设备或机顶盒。
2. 确保ADB调试已启用且正常工作。
3. 启动应用程序——它会显示MCP就绪屏幕，包括：
   • 设备详情
   • 要连接的MCP服务器地址
4. 在您的LLM客户端（例如Goose、Claude Desktop）上：
   • 创建一个新的连接器/扩展。
   • 输入来自电视的服务器地址。
5. 开始使用自然语言控制您的电视：
   • 打开应用
   • 列出已安装的应用
   • 更多命令即将推出

贡献

非常欢迎贡献！

• 提交包含新功能、工具或修复的拉取请求。
• 鼓励提出扩展控制和实用程序的想法。
• 提交更改时，请遵循典型的开源礼仪。

许可证

此项目根据MIT许可证授权——详情见LICENSE文件。 </中文翻译>