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

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

⚠️ 进行中 本项目目前处于早期开发阶段。特征可能不完整、不稳定或可能发生变化。 随着项目的发展，欢迎大家的贡献和反馈。

为什么选择Android TV？

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

⚠️ 注意：出于安全原因，这只应在本地网络上运行，暴露电视在互联网上是很大风险。

特色

MCP on Android TV

A Model Context Protocol (MCP) server running directly on your Android TV devices.

By leveraging ADB (Android Debug Bridge), it allows local network control of your Android TV through any LLM agent or client that supports remote MCP servers. This makes it possible to open apps, list apps, and run other commands on your TV using natural language.

⚠️ Work in Progress
This project is in an early stage of development. Features may be incomplete, unstable, or subject to change.
Contributions and feedback are very welcome as the project evolves.

Why Android TV?

• Simpler ADB setup: On Android TV, ADB debugging can be activated and connected to without requiring pairing.
• Stable local connection: Unlike wireless debugging on phones, the connection does not cycle, giving you a direct link to the device.
• MCP integration: With MCP layered on top of ADB, any LLM client supporting custom MCP servers (such as Goose or Claude Desktop) can act as a controller for your TV.

⚠️ Note: For security reasons this should only be made to work on your local network, exposing your TV to the internet is a big risk.

Features

• Direct ADB integration without pairing.
• MCP server running on Android TV devices.
• Works with the MCP Kotlin SDK 0.7.2 (official SDK).
• Local network device control via LLM clients.
• Current communication method: SSE (deprecated).

Exposed MCP Tools

The MCP server currently supports the following tools:

• [x] launch_tv_app — Launch a TV application by its package name.
• [x] get_installed_tv_apps — Get a list of installed TV applications.
• [x] take_screenshot — Take a screenshot of the device screen.
• [x] send_key_event — Send a key event to the device.
• [x] send_nav_key_event — Send a navigational key event (up, down, left, right, select, back, home).
• [x] type_text — Type text into the current input field.
• [x] tap_screen — Tap the screen at specific coordinates.

Installation & Usage

1. Build & install the app on your Android TV device or set-top box.
2. Ensure ADB debugging is enabled and working.
3. Launch the app — it will display the MCP Ready screen with:
   • Device details
   • MCP server address to connect to
4. On your LLM client (e.g., Goose, Claude Desktop):
   • Create a new connector/extension.
   • Enter the server address from your TV.
5. Start using natural language to control your TV:
   • Open apps
   • List installed apps
   • More commands coming soon

Contributing

Contributions are very welcome!

• Submit a pull request with new features, tools, or fixes.
• Ideas for extended control and utilities are encouraged.
• Please follow typical open-source etiquette when submitting changes.

License

This project is licensed under the MIT License—see the LICENSE file for details.