MCP 工具链
59 个工具按用途分组。所有工具返回 content[].text 与 structuredContent;失败统一为 {ok, error, message, retryable, hint}。聚合器额外多两个设备管理工具,并且每个工具都接受可选的 device 参数。
以 action 为首参的工具(wad_debug / wad_cloud 等),参数支持平铺或放进 args,两种写法等价。
核心(状态 / 小程序 / 账号 / 设置 / 元素)
| 工具 | 用途 | 关键参数 |
|---|---|---|
wad_status | 一屏总览:设备、小程序、账号、捕获、插件、配置。先调它 | — |
wad_capabilities | 能力集 / 工具分组 / 限制;search 按关键词找工具 | search, group |
wad_help | 按主题给操作指引(reverse / debug / network / plugin / snapshot / errors) | topic |
wad_list_apps | 正在运行的小程序及 logic/render 连接状态 | — |
wad_open_app | 打开小程序(appid / username / name),可带启动路径与等待 | appid, path, waitMs |
wad_close_app | 关闭指定小程序 | appid |
wad_list_recent | 最近使用(本地信息索引,AI 首选):带名称/APPID/头像、最近使用时间与最近更新时间,离线可查 | limit, cursor |
wad_search_apps | 历史小程序查询(与 wad_list_recent 同源,支持过滤/排序/分页):按名称模糊 / APPID / 原始 ID(带不带 @app 都行)查 | q, appid, username, sort, limit, cursor |
wad_list_accounts | 账号列表与在线状态 | — |
wad_switch_account | 切换账号(会杀运行时) | id |
wad_login_start / wad_login_poll | 扫码登录:起会话 / 轮询直至授权完成 | session, waitMs |
wad_get_settings / wad_set_settings | 读 / 写设置;写完返回 restartRequired | key, value, patch |
wad_list_plugins | 已装插件与启停状态 | q, enabled, cursor |
wad_install_plugin | 安装插件(html / url / path,可带 sha256),装前语法预检 | html, url, path, enable |
wad_take_snapshot | 元素树快照,返回 rev 与节点 uid(后续点击的定位凭证) | layer, appid, maxNodes |
wad_click | 按 uid / 选择器 / 可见文本点击;带 rev 防过期误点 | uid, selector, text, rev |
wad_fill | 填输入框(派发 input / change 事件) | uid, selector, text, rev |
wad_evaluate_script | 在 logic / render / panel 层执行 JS | layer, expression, byValue |
wad_take_screenshot | 截图(渲染层或指定元素) | format, quality, fullPage, uid |
wad_list_network_requests | 网络记录列表(过滤:filter / method / status / mime) | filter, method, status |
wad_get_network_request | 单条完整请求 / 响应体 | id, body |
wad_list_console_messages | console 消息(logic / render / panel,带级别过滤) | layer, levels, limit |
wad_wait_for | 长轮询等待:文本 / 选择器 / 路由 / 网络 / 表达式 / 启动完成 | text, selector, route, expr, timeoutMs |
wad_batch | 顺序执行 1–20 个工具调用 | ops, stopOnError |
wad_api | 直调任意内部 /v1 接口(没有专用工具时的逃生口) | method, path, query, body |
wad_tools | 询问手机端支持哪些工具(list / describe / call / groups),向前兼容通道 | action, name, args |
逆向(脚本 / 断点 / 单步 / 发起点 / WebSocket / 钩子)
| 工具 | 用途 | 关键参数 |
|---|---|---|
wad_list_scripts | 已加载脚本清单(scriptId ↔ URL) | filter, groupBy |
wad_get_script_source | 脚本源码或局部窗口(压缩包用 line / contextLines 开窗) | scriptId, line, contextLines |
wad_save_script_source | 把脚本存到宿主,返回下载 URL 与 sha256 | scriptId |
wad_search_scripts | 跨脚本文本 / 正则搜索,返回真实行列 | query, regex, scriptFilter |
wad_find_api_usage | API 雷达:扫描 wx.* 调用与 sign / encrypt / token 等关键词 | apis, keywords |
wad_set_breakpoint_on_text | 按代码文本下断点;可选 action 只记录不暂停 | text, scriptFilter, action |
wad_break_on_xhr | 按 URL 匹配断 XHR | urlPattern, method |
wad_list_breakpoints / wad_remove_breakpoint | 断点列表(命中数)/ 删除(all:true 清空) | id, all |
wad_pause_or_resume / wad_step | 暂停恢复 / 单步(over / into / out / resume) | action, kind |
wad_get_paused_info | 暂停现场:调用栈、每帧作用域与局部变量、源码上下文 | includeScopes, maxFrames |
wad_get_request_initiator | 请求发起调用栈:接口 → 代码位置 | id, url |
wad_get_websocket_messages | WebSocket 会话与帧 | id, direction, filter |
wad_ws | WebSocket 全生命周期:list / frames / send / block / rewrite / status | action, id, data, find, replace |
wad_hooks | 持久钩子:net.request / net.response / logic,即写即生效 | action, phase, code, match |
调试器(单工具全动作)
| 工具 | 用途 |
|---|---|
wad_debug | 全部调试器动作:enable / status / break / wait_for_pause / stack / scopes / evaluate / set_variable / contexts…(action 区分) |
渲染层(DOM / 输入)
| 工具 | 用途 |
|---|---|
wad_dom | DOM 检查:html / tree / query / attrs / styles / box / mutation(render 或 panel 层) |
wad_interact | 输入注入:hover / drag / press_key / type_text / select_option / scroll / click_at |
网络(控制面 / 任意请求)
| 工具 | 用途 |
|---|---|
wad_network | 网络控制面:list / get / wait / replay / sitemap / rules / scripts / export |
wad_http | 用小程序自己的 wx.request 栈发任意请求(自带平台信封),返回 status / headers / body |
云开发(已解密 + 主动调用)
| 工具 | 用途 |
|---|---|
wad_cloud | 云开发全部能力。action=list/get/tags/rules/scripts/keys/decode/build/… 操作五类来源的记录与改写;主动调用:gw_token / ct_token(取云网关 / 云托管 V3 凭证)、jsop / jsop_raw(直发 js-operate-wx-data)、app_info(查小程序最新基础信息)。这些调用走账号会话,不经容器、不受插件与改写影响、不进捕获,结果只在响应里返回 |
Native 与捕获开关
| 工具 | 用途 |
|---|---|
wad_native | JSAPI 边界:list / get / credentials / capture_set / hook_set / decode / extract |
wad_capture | 捕获开关与缓冲:network / native / console / render 的 status / set |
插件
| 工具 | 用途 |
|---|---|
wad_plugin | 插件生命周期与面板:get / set_enabled / global / uninstall / reload / market_search / logs / panel_open / panel_close / evaluate / files_* |
文件 / 存储 / 事件
| 工具 | 用途 |
|---|---|
wad_files | 文件树 / 读取 / 搜索 / 下载 / 打包:scripts、plugin、net、native、logs、shots、snapshots |
wad_storage | 小程序 Storage:list / get / set / remove / clear / dump |
wad_events | 统一事件流:list / wait / record / stop(带游标) |
账号维护与小程序生命周期
| 工具 | 用途 |
|---|---|
wad_account | list / ping / logout / health / remove |
wad_app | restart(hard:true 重建运行时)/ search / info / action(关弹窗、查更新) |
原始 CDP
| 工具 | 用途 |
|---|---|
wad_cdp | send / list / domains:逻辑层完整 CDP,渲染层短连接,面板仅 Runtime.evaluate |
聚合器专属(Studio MCP)
| 工具 | 用途 |
|---|---|
wad_devices | 设备列表:alias、uuid、机型、传输方式、mcpVersion、在线状态 |
wad_device_use | 把会话默认设备固定为指定设备 |
向前兼容
手机端新增工具而聚合器未更新时,用 wad_tools {action:"call", name:"<新工具>", args:{…}} 直接调用;wad_tools {action:"list"} 能看到手机端的全部工具与 since 版本。