AI导哈

Android TV控制服务

用于控制Android TV设备的服务器，支持设备发现、配对、遥控、文本输入和应用程序启动。

  • by dmarkey
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dmarkey/android-tv-mcp

使用说明

安卓电视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-mcp

MCP客户端配置

克劳德桌面/克劳德代码

添加到MCP设置中：

{
  "mcpServers": {
    "android-tv": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/dmarkey/android-tv-mcp.git", "android-tv-mcp"]
    }
  }
}

用法

首次设置

  1. 发现设备 在您的网络上： discover_devices
  2. 开始配对 使用设备： start_pairing(host="192.168.1.100", device_id="living_room")
  3. 输入代码 在您的电视上显示： 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 删除已保存的设备

许可证

麻省理工学院

相关 MCP