安卓电视mcp
用于控制Android电视设备的MCP服务器。支持设备发现、配对、远程控制(d-pad、音量、电源、媒体)、文本输入和应用程序启动。
安装
直接从GitHub安装:
uv tool install git+https://github.com/dmarkey/android-tv-mcp.git或者直接运行而不安装:
uvx --from git+https://github.com/dmarkey/android-tv-mcp.git android-tv-mcpMCP客户端配置
克劳德桌面/克劳德代码
添加到MCP设置中:
{
"mcpServers": {
"android-tv": {
"command": "uvx",
"args": ["--from", "git+https://github.com/dmarkey/android-tv-mcp.git", "android-tv-mcp"]
}
}
}用法
首次设置
- 发现设备 在您的网络上:
discover_devices - 开始配对 使用设备:
start_pairing(host="192.168.1.100", device_id="living_room") - 输入代码 在您的电视上显示:
finish_pairing(device_id="living_room", code="123456")
控制你的电视
当您使用任何控制工具时,设备会自动连接——不需要明确的连接步骤。
send_key(device_id="living_room", key="HOME")
send_key(device_id="living_room", key="DPAD_UP")
send_key(device_id="living_room", key="DPAD_CENTER")
send_key(device_id="living_room", key="VOLUME_UP")
send_text(device_id="living_room", text="search query")
launch_app(device_id="living_room", app_link="https://www.youtube.com")
get_device_status(device_id="living_room")可用密钥
| 类别 | 密钥 |
|---|---|
| 导航 | DPAD_UP, DPAD_DOWN, DPAD_LEFT, DPAD_RIGHT, DPAD_CENTER |
| 系统 | HOME, BACK, MENU, POWER |
| 音量 | VOLUME_UP, VOLUME_DOWN, MUTE |
| 媒体中心 | MEDIA_PLAY_PAUSE, MEDIA_STOP, MEDIA_NEXT, MEDIA_PREVIOUS, MEDIA_REWIND, MEDIA_FAST_FORWARD |
| 应用程序 | YOUTUBE |
| 资讯 | INFO, GUIDE, SEARCH |
| 数字 | 0-9 |
| 颜色 | PROG_RED, PROG_GREEN, PROG_YELLOW, PROG_BLUE |
| 频道 | CHANNEL_UP, CHANNEL_DOWN |
键重复
使用 repeat 参数,用于多次发送密钥(1-50),可用于音量调整:
send_key(device_id="living_room", key="VOLUME_DOWN", repeat=10)长按
使用 direction 参数: START_LONG 为了开始保持, END_LONG 释放。
工具
| 工具 | 说明 |
|---|---|
discover_devices | 扫描网络以查找Android电视设备 |
list_devices | 列出已保存的设备 |
start_pairing | 开始配对(电视显示代码) |
finish_pairing | 与代码完全配对 |
disconnect | 断开与设备的连接 |
send_key | 发送遥控钥匙 |
send_text | 在电视上键入文本 |
launch_app | 通过深度链接启动应用程序 |
get_device_status | 获取电源、应用程序、音量状态 |
remove_device | 删除已保存的设备 |
许可证
麻省理工学院
