servers / yfme-weapp-dev-mcp

@yfme/weapp-dev-mcp

communityunknownnpmwrite capablehealthy

FastMCP server for automating WeChat Mini Program developer tooling - Enhanced with auto-launch and stability fixes


01Tools · 30

How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.

ToolRiskSide effectsApproval
mp_getLogs
获取小程序控制台日志。可选择在获取后清空日志。
readfalseunknown
page_getElements
通过选择器获取页面元素数组,相当于 page.$$(selector)。返回每个元素的摘要信息(tagName、text、value、size、offset);设置 withWxml 为 true 可额外返回每个元素的完整 outerWxml。支持 [index=N] 语法选择第 N 个元素。
readfalseunknown
element_callMethod
调用组件实例指定方法,仅自定义组件可以使用。
unknownunknownunknown
element_getStyles
获取元素的样式值。names 为样式名数组(如 ['color', 'fontSize', 'backgroundColor'])。
readfalseunknown
mp_mockWxMethod
有限 mock wx 方法能力。当前仅支持 method=request:action=mock 时按 requestRules mock wx.request 成功响应;action=restore 时恢复 wx.request。未匹配请求默认透传原始 wx.request。
unknownunknownunknown
mp_setDefaultProject
设置默认的小程序项目路径,设置后下次连接会优先使用该项目。通常用于修复项目选择失败后的后续重试。
writetrueunknown
mp_navigate
在小程序内导航,支持 navigateTo、redirectTo、reLaunch、switchTab 和 navigateBack。
unknownunknownunknown
mp_ensureConnection
检查小程序自动化会话是否就绪。先调用这个工具,再调用 mp_screenshot、page_* 或 element_* 工具。若失败,优先用 reconnect=true 重试一次;若返回项目选择提示,则传 projectSelection。
unknownunknownunknown
mp_screenshot
截取当前小程序视口的截图。需要已有活动会话;若提示没有活动会话,请先调用 mp_ensureConnection。默认返回内联图片,或保存到文件路径。
unknownunknownunknown
mp_callWx
调用微信小程序 API 方法,(如 `wx.pageScrollTo`)。
unknownunknownunknown
mp_currentPage
获取当前页面的信息,包括路径、查询参数、尺寸、滚动位置、当前页面真实渲染器 renderer,以及 wx.getSkylineInfoSync() 的 Skyline 诊断信息 skylineInfo。通常在 mp_ensureConnection 成功后立即调用,用于确认当前页面;可通过 renderer 区分 webview/skyline,skylineInfo 仅用于判断运行环境能力。withData 为 true 时额外返回页面数据。
unknownunknownunknown
page_getElement
通过选择器获取页面元素,相当于 page.$(selector)。返回每个元素的摘要信息(tagName、text、value、size、offset);设置 withWxml 为 true 可额外返回元素的完整 outerWxml。支持 [index=N] 语法选择第 N 个元素。
readfalseunknown
page_getElementByXpath
通过 XPath 获取页面第一个匹配元素,相当于 page.getElementByXpath(xpath) / page.xpath(xpath)。适合按文本、层级关系、ancestor/following 等 XPath 表达式定位元素;设置 withWxml 为 true 可额外返回完整 outerWxml。
readfalseunknown
page_getElementsByXpath
通过 XPath 获取页面匹配元素数组,相当于 page.getElementsByXpath(xpath)。适合按文本、属性、层级关系、位置函数等 XPath 表达式批量定位元素;设置 withWxml 为 true 可额外返回每个元素的完整 outerWxml。
readfalseunknown
page_waitElement
等待指定选择器的元素出现在页面上。支持 [index=N] 语法选择第 N 个元素。增强版:增加了超时和重试间隔参数。
unknownunknownunknown
page_getData
获取当前页面的数据对象,可选择指定子数据路径。
readfalseunknown
page_setData
使用 setData 更新当前页面的数据。
writetrueunknown
page_callMethod
调用当前页面实例上暴露的方法。参数可以作为数组提供。
unknownunknownunknown
element_tap
通过 CSS 选择器模拟点击 WXML 元素。支持 [index=N] 语法选择第 N 个元素。如需点击自定义组件内部的元素,请使用 innerSelector 参数:selector 设为组件 ID 选择器(如 #my-component)或标签选择器,innerSelector 设为组件内部元素的选择器。
unknownunknownunknown
element_input
向指定元素输入文本。
unknownunknownunknown
element_getData
获取组件实例渲染数据,仅自定义组件可以使用。
readfalseunknown
element_getWxml
获取元素 WXML。默认获取内部 WXML(element.wxml()),设置 outer 为 true 可获取包含元素本身的 WXML(element.outerWxml())。
readfalseunknown
element_getBoundingClientRect
获取元素相对于视口的边界矩形信息(left、top、width、height、right、bottom)。此方法返回的是考虑 CSS transform 变换后的实际渲染尺寸和位置。仅支持 ID 选择器、类选择器。若目标元素位于自定义组件内部,selector 必须指向当前页面 WXML 源码中直接引用的那一层自定义组件,而不是渲染后的组件树;innerSelector 可在 selector 所指组件的整个子树内匹配。
readfalseunknown
element_setData
设置组件实例渲染数据,仅自定义组件可以使用。
writetrueunknown
element_getInnerElement
在元素范围内获取元素,相当于 element.$(selector)。设置 withWxml 为 true 可额外返回每个元素的完整 outerWxml。
readfalseunknown
element_getInnerElements
在元素范围内获取元素数组,相当于 element.$$(selector)。设置 withWxml 为 true 可额外返回每个元素的完整 outerWxml。
readfalseunknown
element_scrollTo
滚动 scroll-view 组件到指定位置。仅适用于 scroll-view 组件。
readfalseunknown
element_getAttributes
获取元素的特性值。names 为特性名数组(如 ['class', 'id', 'data-index'])。
readfalseunknown
page_waitTimeout
等待指定的毫秒数。
unknownunknownunknown
mp_listProjects
列出微信开发者工具中的最近项目,方便在 mp_ensureConnection 返回项目选择提示后继续选择项目。
readfalseunknown

02Install & source
npx -y @yfme/weapp-dev-mcp
npx

05Provenance & freshness
sourcesnpm registry [p4]
last_checked2026-08-16 19:59Z
next_check2026-08-16 22:59Z
cadenceevery 3h
verifiedhandshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed
index_statusindex7 unique facts >= 5

06Badge

Add the “as seen on MCPExplorer” badge to your README. @yfme/weapp-dev-mcp MCP — as seen on mcpexplorer.com

[![@yfme/weapp-dev-mcp MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/yfme-weapp-dev-mcp.svg)](https://mcpexplorer.com/servers/yfme-weapp-dev-mcp)

Next step

This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.

Explore loadouts →