Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WEAPP_AUTOCLOSE | No | 设置为 true 时，每次工具调用后关闭开发者工具会话 | |
| WEAPP_WS_ENDPOINT | No | 【推荐】已运行的开发者工具 WebSocket 端点。设置后，服务器使用 connect 模式而不是启动新实例。示例：ws://localhost:9420 | |
| WEAPP_AUTO_ACCOUNT | No | 传递给 --auto-account 用于自动登录 | |
| WEAPP_DEVTOOLS_CWD | No | 传递给开发者工具进程的工作目录 | |
| WEAPP_DEVTOOLS_ARGS | No | 启动时的额外 CLI 参数（空格分隔） | |
| WEAPP_DEVTOOLS_PORT | No | 启动开发者工具时的首选端口（回退到可用端口） | |
| WEAPP_TRUST_PROJECT | No | 设置为 true 以在启动时包含 --trust-project | |
| WEAPP_AUTOMATOR_MODE | No | 强制使用 launch 或 connect 模式。除非提供了 WEAPP_WS_ENDPOINT，否则默认为 launch | |
| WEAPP_DEVTOOLS_TICKET | No | 启动时传递给 --ticket | |
| WEAPP_DEVTOOLS_TIMEOUT | No | 启动超时时间（毫秒，默认 30000） | 30000 |
| WECHAT_DEVTOOLS_CLI_PATH | No | 微信开发者工具 CLI 路径（如果默认路径有效则可选） |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mp_ensureConnection | 检查小程序自动化会话是否就绪。可选择覆盖连接设置或强制重连。 |
| mp_navigate | 在小程序内导航，支持 navigateTo、redirectTo、reLaunch、switchTab 和 navigateBack。 |
| mp_screenshot | 截取当前小程序视口的截图。默认返回内联图片，或保存到文件路径。 |
| mp_callWx | 调用微信小程序 API 方法。 |
| mp_getLogs | 获取小程序控制台日志。可选择在获取后清空日志。 |
| page_getElement | 通过选择器获取页面元素。 |
| page_waitElement | 等待指定选择器的元素出现在页面上。注意：此方法不适用于自定义组件内部元素，仅能等待页面级别的元素。如需等待自定义组件内部元素，请使用 page_waitTimeout 配合 element 相关工具进行轮询检查。 |
| page_waitTimeout | 等待指定的毫秒数。 |
| page_getData | 获取当前页面的数据对象，可选择指定路径。 |
| page_setData | 使用 setData 更新当前页面的数据。 |
| page_callMethod | 调用当前页面实例上暴露的方法。参数可以作为数组提供。 |
| element_tap | 通过 CSS 选择器模拟点击 WXML 元素。如需点击自定义组件内部的元素，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。 |
| element_input | 向指定元素输入文本。如需向自定义组件内部的元素输入，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。 |
| element_callMethod | 调用组件实例指定方法，仅自定义组件可以使用。需要 automator 0.6.0 和基础库 2.9.0 及以上版本。使用 ID 选择器(如 #my-component)定位自定义组件。 |
| element_getData | 获取组件实例渲染数据，仅自定义组件可以使用。需要 automator 0.6.0 和基础库 2.9.0 及以上版本。使用 ID 选择器(如 #my-component)定位自定义组件。 |
| element_setData | 设置组件实例渲染数据，仅自定义组件可以使用。需要 automator 0.6.0 和基础库 2.9.0 及以上版本。使用 ID 选择器(如 #my-component)定位自定义组件。 |
| element_getInnerElement | 在元素范围内获取元素，相当于 element.$(selector)。重要：操作自定义组件内部元素时，必须先通过 ID 选择器(如 #my-component)定位自定义组件，然后使用此工具获取组件内部的元素。 |
| element_getInnerElements | 在元素范围内获取元素数组，相当于 element.$$(selector)。重要：操作自定义组件内部元素时，必须先通过 ID 选择器(如 #my-component)定位自定义组件，然后使用此工具获取组件内部的元素数组。 |
| element_getSize | 获取元素大小(宽度和高度)。如需获取自定义组件内部元素的大小，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。 |
| element_getWxml | 获取元素 WXML。默认获取内部 WXML(element.wxml())，设置 outer 为 true 可获取包含元素本身的 WXML(element.outerWxml())。如需获取自定义组件内部元素的 WXML，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |