MCP 工具列表
共 43 个工具,Claude Code / Cursor / 任意 MCP 客户端可直接调用。
接入方式见 MCP 集成。HTTP 版接口见 HTTP REST API。
设备控制 (7)
| 工具 | 参数 | 说明 |
|---|---|---|
list_devices | — | 列出 Android + iOS 设备 + 状态 |
screenshot | {serial, scale?, format?, quality?, region?} | 截图(默认 scale=0.5 省 4x token) |
tap | {serial, x, y} 或 {serial, label} | 按坐标或文字点击 |
swipe | {serial, fx, fy, tx, ty, ms?} | 滑动 |
input_text | {serial, text} | 输入文字(ASCII + 中文) |
press_key | {serial, keycode} | 按键 |
launch_app | {serial, action?, package?, force?} | 启动 app |
UI 观察 (4)
| 工具 | 说明 |
|---|---|
dump_ui | UI 树 XML(Android uiautomator / iOS WDA source) |
find_element | 按文字找坐标,返回 {x, y, bounds, mode} |
assert_text | 子串 / 正则断言屏上有某文字 |
assert_visual | Gemini 视觉断言,prompt 自然语言 |
AI 视觉 (6)
| 工具 | 说明 |
|---|---|
ocr | Gemini OCR 文字识别(整屏或区域) |
analyze_screen | 服务器侧 Gemini 读屏,返回元素/文字/异常 JSON |
get_elements | 结构化元素列表(比 dump_ui 精简) |
detect_anomaly | 查错位 / 空白 / 报错等 UI 异常 |
smart_tap | 按自然语言描述找元素并点击 |
compare_screens | 前后两屏 diff |
App 生命周期 (5)
| 工具 | 说明 |
|---|---|
install_app | 安装 APK / .app(Android adb + iOS simctl 双端) |
uninstall_app | 卸载 |
reset_app | 清数据(Android pm clear / iOS privacy reset + terminate) |
list_packages | 列已装 app(Android + iOS simctl listapps) |
explore_app | AI 自动探索 app,生成功能图谱 |
诊断 (6)
| 工具 | 说明 |
|---|---|
wait_stable | 等画面稳定(pHash 连续 N 帧不变) |
dismiss_modal | 自动关弹窗(中英双语规则 + iOS WDA) |
logcat_dump | 抓日志(Android logcat / iOS simctl log show) |
logcat_clear | 清日志(iOS 返 notApplicable) |
detect_crashes | 崩溃检测(Android FATAL/native + iOS DiagnosticReports) |
metrics | 性能指标 CPU/内存/FPS/battery |
录屏 + 录制 (5)
| 工具 | 说明 |
|---|---|
run_script | 执行 DSL YAML |
start_record | 开始录制手势生成 DSL(Android only) |
stop_record | 停止录制 → DSL |
start_screen_record | 开始录屏(Android adb + iOS simctl 双端) |
stop_screen_record | 停止录屏 → MP4/MOV |
Web 自动化 (5)
| 工具 | 说明 |
|---|---|
web_list_tabs | Chrome 打开的标签页 |
web_navigate | 导航 {tabIndex, url} |
web_execute_js | 执行 JS |
web_get_dom | 获取页面 HTML |
web_click | 按 selector 点击 |
完整 Web DSL actions(webType / webAssert / webWaitFor / webScreenshot)见 DSL 动作列表。
系统 (5)
| 工具 | 说明 |
|---|---|
set_locale | 切换系统语言(Android only;iOS 返 notApplicable) |
forward | 端口转发(adb reverse / iOS 不支持) |
ime_list | IME 列表(Android) |
ime_set | 切换 IME(Android) |
setup_chinese_input | 装 + 启用 ADBKeyboard(Android) |
共同约定
错误返回
json
{
"content": [{ "type": "text", "text": "error: device not found" }],
"isError": true
}图片返回(screenshot / assert_visual 等)
走 MCP 标准 image content block:
json
{
"content": [{ "type": "image", "data": "<base64>", "mimeType": "image/jpeg" }]
}Claude Vision tokens ≈ width × height / 750。降分辨率是最有效的省 token 手段。
serial 参数
- Android:
emulator-5554/ 真机 serial - iOS:UDID(8-4-4-4-12 格式十六进制字符串)
- 自动 dispatch:Tapilot 根据 serial 格式判断是哪个平台
iOS 不适用说明
下列 tool 在 iOS 上返回 {notApplicable: true, reason: "..."} 而不是报错:
start_record(iOS 无 gesture capture API)logcat_clear(iOS 日志由系统管理,无 clear 概念)ime_list/ime_set/setup_chinese_input(iOS wdaInput 原生支持 Unicode,无需 IME 切换)
相关
- MCP 接入指南 — Claude Code / Cursor 配置
- HTTP REST API — 用 HTTP 调同一套能力
- DSL 动作列表 — 把 MCP tool 组合成脚本的声明式语法