page_getElementByXpath
通过 XPath 获取页面第一个匹配元素,适合按文本、属性、层级关系、ancestor/following 等表达式定位;设置 withWxml: true 可额外返回完整 outerWxml
How to use it
Project documentation lists page_getElementByXpath for the Weapp Dev MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Weapp Dev MCP
npx -y @yfme/weapp-dev-mcpOther tools in Weapp Dev MCP (29)
调用自定义组件实例的方法
获取元素的特性值,names 参数为特性名数组(如 ['class', 'id', 'data-index'])
获取元素相对于视口的边界矩形信息(left、top、width、height、right、bottom),考虑 CSS transform 变换;选择器支持微信小程序 SelectorQuery 子集(ID、class、连续 class、子代、后代、跨自定义组件后代和并集选择器)
获取自定义组件实例的渲染数据
获取元素内的元素(相当于 element.$(selector)),返回元素摘要信息;设置 withWxml: true 可额外返回完整 outerWxml
获取元素内的元素数组(相当于 element.$$(selector)),返回元素摘要信息;设置 withWxml: true 可额外返回每个元素的完整 outerWxml
获取元素的 CSS 样式值,names 参数为样式名数组(如 ['color', 'fontSize'])
获取元素 WXML(内部或外部)
向元素输入文本(适用于 input 和 textarea 组件)
滚动 scroll-view 组件到指定位置(x, y)
设置自定义组件实例的渲染数据
通过 CSS 选择器模拟点击 WXML 元素;支持 [index=N] 语法选择第 N 个元素;支持 x/y 坐标偏移点击;增强稳定性:等待元素可交互状态,点击后自动验证页面路径是否变化
调用微信小程序 API 方法(如 wx.showToast)
获取当前页面信息(路径、查询参数、尺寸、滚动位置),withData 为 true 时额外返回页面数据
确保自动化会话就绪;可选择强制重连或覆盖连接设置
获取小程序控制台日志,可选择获取后清除
列出微信开发者工具中的最近项目,方便选择项目目录
有限 mock wx 方法能力;当前支持 method: "request",通过 action: "mock" 设置 wx.request 规则,通过 action: "restore" 恢复原方法
在小程序内导航,支持 navigateTo、redirectTo、reLaunch、switchTab 或 navigateBack
捕获屏幕截图并返回(或保存到磁盘);若微信开发者工具的自动化截图接口失败或超时,请改用客户端/系统提供的截图 API 截取开发者工具模拟器区域
设置默认的小程序项目路径,设置后下次连接会自动使用该项目
调用当前页面实例上暴露的方法
获取当前页面的数据对象,可指定路径(支持嵌套路径如 'user.name')
通过选择器获取页面元素,返回元素摘要信息(tagName、text、value、size、offset);设置 withWxml: true 可额外返回完整 outerWxml;支持 [index=N] 语法选择第 N 个元素
通过选择器获取页面元素数组,返回每个元素的摘要信息;设置 withWxml: true 可额外返回每个元素的完整 outerWxml;支持 [index=N] 语法
通过 XPath 获取页面匹配元素数组,返回每个元素的摘要信息;设置 withWxml: true 可额外返回每个元素的完整 outerWxml
使用 setData 更新当前页面的数据;增加 verify 选项,验证数据是否真正更新成功
等待元素出现在页面上(⚠️ 不适用于自定义组件内部元素);支持 [index=N] 语法;增加超时和重试间隔参数
等待指定的毫秒数