android-mobile-mcp

🚀 Android Mobile MCP

Android Mobile MCP 搭建了模型上下文协议与安卓设备自动化之间的桥梁，使 AI 代理能够通过 UI 操作、应用管理和屏幕截图等方式与安卓设备进行交互。

🚀 快速开始

前提条件

1. 通过 USB 或网络连接安卓设备。
2. 在安卓设备上启用 USB 调试。
3. 安装 ADB（安卓调试桥）。

📦 安装指南

在配置文件中添加以下内容：

{
  "mcpServers": {
    "android-mobile-mcp": {
      "command": "uvx",
      "args": ["android-mobile-mcp"]
    }
  }
}

📚 详细文档

工具参考

屏幕分析

• mobile_dump_ui - 将 UI 元素提取为分层 JSON
  • 解析屏幕 XML 以识别可聚焦元素和文本内容。
  • 计算每个交互元素的中心坐标。
  • 返回结构化的父子元素关系。
• mobile_take_screenshot - 捕获当前屏幕状态
  • 返回 PNG 图像数据以进行视觉分析。

触摸交互

• mobile_click - 在特定坐标处点击
  • 根据当前 UI 状态验证坐标。
  • 需要事先调用 mobile_dump_ui 进行坐标验证。
  • 防止点击无效或非交互区域。
• mobile_swipe - 执行滑动手势
  • 在两个坐标点之间执行定向滑动。
  • 可配置滑动持续时间以控制手势速度。

文本输入

• mobile_type - 在聚焦字段中输入文本
  • 将文本发送到当前活动的输入字段。
  • 可选择使用回车键自动提交。

导航

• mobile_key_press - 按下系统按钮
  • 支持硬件和虚拟按键：返回、主页、最近任务、回车键。

应用管理

• mobile_list_apps - 列出已安装的应用程序
  • 过滤掉系统应用和不可启动的软件包。
  • 仅返回用户可访问的应用程序。
• mobile_launch_app - 按软件包名称启动应用程序
  • 在尝试启动前验证软件包是否存在。