本地 Android 工具

Android 工作台

在 MCP 客户端操作 Android 设备、回放界面测试,并检查 APK、ELF 和内核模块。

VANTAMCP / STDIO
  1. MCP 客户端
  2. Vanta
  3. Android
发行版本
v0.11.0 预览版
运行环境
Node.js 22 / 24
开源协议
MIT

前台交互

Device Use.

同时读取截图与 UI 树,用控件选择器定位操作目标,并把步骤保存为可重复执行的回归用例。

device_use交互示例

请求

{
  "action": "observe",
  "session": "SESSION_ID",
  "image": true,
  "tree": true
}

返回一帧 PNG 截图及其对应的 UI 树。

在已解锁的设备上操作前台应用,支持按键、长按和可调速度的滑动。选用 Vanta 输入法后,可输入 Unicode 字符和符号。

查看完整回放样例

分析与诊断

分析工具

从应用界面到原生库和内核,按问题选择工具。

APK 与 ELF

比较基础 APK 与分包的 Manifest、DEX 和原生库,定位 ABI、依赖或 16 KB 对齐问题。

apk_inspect

VM 轨迹

对比已有的 VM 执行轨迹,定位操作码、状态摘要和控制流的差异。

vm_trace

Root 诊断

查看进程、线程、内存映射和设备日志。运行测试进程时,记录 PID、启动 tick 和退出状态。

run

内核模块

核对 .ko 的架构、vermagic 与符号 CRC。通过已授权的 Root 会话记录模块实验、dmesg 和可用的 pstore 日志。

kernel_snapshot

连接方式

ADB

使用设备已授权的 Android Shell。

Shizuku

通过 ADB 使用已配置的 rish。

Root

对指定操作显式使用设备已有的 Root 授权。

配对 USB 配置适用于 Windows 与使用 KernelSU Next 的 ARM64 测试设备。

本地安装

快速开始

安装 Node.js 22 或 24。将 Android Platform Tools 的 adb 加入 PATH,或设置 ADB_PATH。开启 USB 调试并在设备上授权主机。

Android Platform Tools

从 adb devices -l 的输出中获取 YOUR_SERIAL。

codex mcp add vanta --env VANTA_TRANSPORT=adb --env VANTA_SERIAL=YOUR_SERIAL -- npx --yes --ignore-scripts vanta-mcp@0.11.0

发行验收

验证记录

Android 17 模拟器已通过普通 ADB 与 Shizuku 回放。原生诊断已验证离线 16 KB 对齐检查和模拟器依赖缺失案例。

普通 ADB 回放验收的终端摘要图
Device Use · ADB 回放
原生依赖与对齐检查的终端摘要图
原生诊断 · APK 与 ELF

实体机前台回放、配对 USB 回放、Shizuku 应用级授权撤销与内核取证待复验。

查看 GitHub Actions