Weapp Dev MCP 伺服器 | PlugMCP跳到正文微信小程序 MCP 服务器
基于 FastMCP 的服务器,通过 miniprogram-automator 自动化微信开发者工具。该服务器提供 MCP 工具,让 AI 助手能够导航、检查和操作小程序页面——类似于 playwright-mcp,但专为微信生态系统定制。
⚠️ 官方已下场:建议迁移到微信开发者工具 Skill
微信官方已正式推出「微信开发者工具 Skill」并开启公测,可在 Cursor / Claude 等 AI Agent 环境中直接操作开发者工具:打开项目、编译、模拟器、日志排查、预览上传、云开发等,无需在 IDE 与开发者工具之间反复横跳。
FastMCP server for automating WeChat Mini Program developer tooling
为什么建议迁移?
- 官方维护与版本同步:Skill 随开发者工具 Nightly 发布,与工具能力对齐,不必再维护一套第三方 MCP。
- 覆盖面更广:不止页面自动化,还包括项目导入、编译构建、真机预览、上传、云环境等。
- 更贴近真实工作流:Agent 可直接驱动开发者工具完成「写代码 → 编译 → 看模拟器 / 日志 → 预览」闭环。
官方接入(两步)
/Applications/wechatwebdevtools.app/Contents/Resources/app.asar.unpacked/miniprogram-dev-skill
调用示例(具体以 wechatide / Skill 文档为准):
wechatide # 查看 Skill 路径与可用工具
wechatide -c Cursor -t check_devtools_status # 检查登录与环境
相关链接
前置要求
- 已安装微信开发者工具,支持命令行访问(
cli / cli.bat)
- 本地已安装 Node.js 18+ 和
npm
- 有可以在开发者工具中打开的小程序项目
快速开始(npm 包)
@yfme/weapp-dev-mcp 已发布到 npm,普通使用者无需克隆仓库或手动执行 node dist/index.js。
使用 npx 运行
npx -y @yfme/weapp-dev-mcp
安装到项目/全局
npm install -g @yfme/weapp-dev-mcp
weapp-dev-mcp
npm install --save-dev @yfme/weapp-dev-mcp
npx weapp-dev-mcp
只有在本仓库内开发时,才建议直接运行 node dist/index.js。一般用户请按照以上 npm 包方式启动。
MCP 客户端集成
配置
要在 Claude Desktop 或其他 MCP 客户端中使用此服务器,请在配置文件中添加:
{
"mcpServers": {
"weapp-dev": {
"command": "npx",
"args": [
"-y",
"@yfme/weapp-dev-mcp"
],
"env": {
"WEAPP_WS_ENDPOINT": "ws://localhost:9420"
}
}
}
}
Claude Code 自动批准工具权限
由于使用 Claude Code 调用 MCP 工具时,会触发工具调用权限申请,此时可能会丢失 MCP 与微信开发者工具的连接状态,由于获取控制台输出高度依赖连接状态,此时会无法连贯的获取输出日志,所以建议手动添加权限:
在项目目录下创建 .claude/settings.local.json 文件,或在已有文件添加以下内容后即可免确认直接调用工具,或者根据需要添加您允许免确认调用的工具:
{
"permissions": {
"allow": [
"mcp__weapp-dev-mcp__mp_ensureConnection",
"mcp__weapp-dev-mcp__mp_navigate",
"mcp__weapp-dev-mcp__mp_screenshot",
"mcp__weapp-dev-mcp__mp_callWx",
"mcp__weapp-dev-mcp__mp_mockWxMethod",
"mcp__weapp-dev-mcp__mp_getLogs",
"mcp__weapp-dev-mcp__mp_currentPage",
"mcp__weapp-dev-mcp__mp_listProjects",
"mcp__weapp-dev-mcp__mp_setDefaultProject",
"mcp__weapp-dev-mcp__page_getElement",
"mcp__weapp-dev-mcp__page_getElements",
"mcp__weapp-dev-mcp__page_getElementByXpath",
"mcp__weapp-dev-mcp__page_getElementsByXpath",
"mcp__weapp-dev-mcp__page_waitElement",
"mcp__weapp-dev-mcp__page_waitTimeout",
"mcp__weapp-dev-mcp__page_getData",
"mcp__weapp-dev-mcp__page_setData",
"mcp__weapp-dev-mcp__page_callMethod",
"mcp__weapp-dev-mcp__element_tap",
"mcp__weapp-dev-mcp__element_input",
"mcp__weapp-dev-mcp__element_callMethod",
"mcp__weapp-dev-mcp__element_getData",
"mcp__weapp-dev-mcp__element_setData",
"mcp__weapp-dev-mcp__element_getInnerElement",
"mcp__weapp-dev-mcp__element_getInnerElements",
"mcp__weapp-dev-mcp__element_getWxml",
"mcp__weapp-dev-mcp__element_getStyles",
"mcp__weapp-dev-mcp__element_scrollTo",
"mcp__weapp-dev-mcp__element_getAttributes",
"mcp__weapp-dev-mcp__element_getBoundingClientRect"
]
}
}
注意: 工具名称格式为 mcp__<服务器名称>__<工具名称>,请确保服务器名称与您的 MCP 配置中的名称一致。
启动微信开发者工具
在使用 MCP 服务器之前,需要先启动微信开发者工具并开启 WebSocket 服务。
- 打开微信开发者工具
- 进入 设置 → 安全设置 → 服务端口
- 开启 "HTTP 调试" 和 "自动化测试"
使用命令行启动微信开发者工具并自动开启 WebSocket 服务:
/Applications/wechatwebdevtools.app/Contents/MacOS/cli auto --project /path/to/your/project --auto-port 9420
"C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat" auto --project C:\path\to\your\project --auto-port 9420
--project 参数指定小程序项目目录路径(请替换为实际的项目路径)
--auto-port 参数指定 WebSocket 服务端口(默认 9420)
⚠️ 警告
由于沙箱机制,部分客户端不允许 MCP 访问项目目录以外的微信开发者工具的 cli,所以这里只介绍了使用 WebSocket 服务
环境变量配置
通过环境变量控制自动化工具如何连接到微信开发者工具:
注意: 当启动开发者工具(launch 模式)时,必须通过 MCP 工具参数提供小程序项目目录:在执行操作前通过 connection.projectPath 提供(例如通过 mp_ensureConnection)。该值一旦建立,将在后续调用中持久化。
工具调用可以通过 connection 对象覆盖这些默认值中的大部分。
可用工具
应用工具(Application Tools)
mp_ensureConnection – 确保自动化会话就绪;可选择强制重连或覆盖连接设置
mp_navigate – 在小程序内导航,支持 navigateTo、redirectTo、reLaunch、switchTab 或 navigateBack
mp_screenshot – 捕获屏幕截图并返回(或保存到磁盘);若微信开发者工具的自动化截图接口失败或超时,请改用客户端/系统提供的截图 API 截取开发者工具模拟器区域
mp_callWx – 调用微信小程序 API 方法(如 wx.showToast)
mp_mockWxMethod – 有限 mock wx 方法能力;当前支持 method: "request",通过 action: "mock" 设置 wx.request 规则,通过 action: "restore" 恢复原方法
mp_getLogs – 获取小程序控制台日志,可选择获取后清除
mp_currentPage – 获取当前页面信息(路径、查询参数、尺寸、滚动位置),withData 为 true 时额外返回页面数据
mp_listProjects – 列出微信开发者工具中的最近项目,方便选择项目目录
mp_setDefaultProject – 设置默认的小程序项目路径,设置后下次连接会自动使用该项目
页面工具(Page Tools)
page_getElement – 通过选择器获取页面元素,返回元素摘要信息(tagName、text、value、size、offset);设置 withWxml: true 可额外返回完整 outerWxml;支持 [index=N] 语法选择第 N 个元素
page_getElements – 通过选择器获取页面元素数组,返回每个元素的摘要信息;设置 withWxml: true 可额外返回每个元素的完整 outerWxml;支持 [index=N] 语法
page_getElementByXpath – 通过 XPath 获取页面第一个匹配元素,适合按文本、属性、层级关系、ancestor/following 等表达式定位;设置 withWxml: true 可额外返回完整 outerWxml
page_getElementsByXpath – 通过 XPath 获取页面匹配元素数组,返回每个元素的摘要信息;设置 withWxml: true 可额外返回每个元素的完整 outerWxml
page_waitElement – 等待元素出现在页面上(⚠️ 不适用于自定义组件内部元素);支持 [index=N] 语法;增加超时和重试间隔参数
page_waitTimeout – 等待指定的毫秒数
page_getData – 获取当前页面的数据对象,可指定路径(支持嵌套路径如 'user.name')
page_setData – 使用 setData 更新当前页面的数据;增加 verify 选项,验证数据是否真正更新成功
page_callMethod – 调用当前页面实例上暴露的方法
元素工具(Element Tools)
element_tap – 通过 CSS 选择器模拟点击 WXML 元素;支持 [index=N] 语法选择第 N 个元素;支持 x/y 坐标偏移点击;增强稳定性:等待元素可交互状态,点击后自动验证页面路径是否变化
element_input – 向元素输入文本(适用于 input 和 textarea 组件)
element_callMethod – 调用自定义组件实例的方法
element_getData – 获取自定义组件实例的渲染数据
element_setData – 设置自定义组件实例的渲染数据
element_getInnerElement – 获取元素内的元素(相当于 element.$(selector)),返回元素摘要信息;设置 withWxml: true 可额外返回完整 outerWxml
element_getInnerElements – 获取元素内的元素数组(相当于 element.$$(selector)),返回元素摘要信息;设置 withWxml: true 可额外返回每个元素的完整 outerWxml
element_getWxml – 获取元素 WXML(内部或外部)
element_getStyles – 获取元素的 CSS 样式值,names 参数为样式名数组(如 ['color', 'fontSize'])
element_scrollTo – 滚动 scroll-view 组件到指定位置(x, y)
element_getAttributes – 获取元素的特性值,names 参数为特性名数组(如 ['class', 'id', 'data-index'])
element_getBoundingClientRect – 获取元素相对于视口的边界矩形信息(left、top、width、height、right、bottom),考虑 CSS transform 变换;选择器支持微信小程序 SelectorQuery 子集(ID、class、连续 class、子代、后代、跨自定义组件后代和并集选择器)
每个工具都接受可选的 connection 块来覆盖环境默认值(项目路径、CLI 路径、WebSocket 端点等)。
element_getBoundingClientRect 选择器规则
selector 和 innerSelector 使用微信小程序 SelectorQuery.select 的选择器子集:
- ID 选择器:
#the-id
- class 选择器:
.a-class
- 连续 class:
.a-class.another-class
- 子代选择器:
.the-parent > .the-child
- 后代选择器:
.the-ancestor .the-descendant
- 跨自定义组件后代选择器:
.the-ancestor >>> .the-descendant
- 多选择器并集:
#a-node, .some-other-nodes
不支持标签选择器(如 view)、属性选择器、伪类、相邻/兄弟选择器。若目标元素位于自定义组件内部,建议 selector 指向当前页面 WXML 中直接引用的组件节点,再用 innerSelector 定位组件内部元素。
Mock 网络请求
mp_mockWxMethod 只开放少量安全的 mockWxMethod 能力,当前用于 mock wx.request。同一个工具同时支持设置和恢复:
{
"action": "mock",
"method": "request",
"requestRules": [
{
"url": "/api/user",
"match": "contains",
"method": "GET",
"statusCode": 200,
"data": {
"id": 1,
"name": "test"
}
}
]
}
match 支持 contains、exact、regex。命中规则的请求会返回配置的成功响应;未命中规则时透传原始 wx.request。需要恢复时:
{
"action": "restore",
"method": "request"
}
使用技巧
一般提示
- 连接前,在微信开发者工具中启用自动化(
设置 → 安全设置 → 服务端口)
- 推荐首先调用
mp_ensureConnection 来验证连接并查看系统/页面详情
- 使用
WEAPP_AUTOCLOSE=true 适合无状态的一次性交互
- 导航时始终使用绝对路径(以
/ 开头):/pages/mine/mine
- tabBar 页面使用
switchTab,普通页面使用 navigateTo
操作自定义组件
方法一:使用 innerSelector 参数(推荐)
适用于 element_tap、element_input、element_getWxml 等工具:
{
"selector": "#my-component",
"innerSelector": ".inner-button"
}
selector:自定义组件的选择器
innerSelector:组件内部元素的选择器
方法二:使用元素内查询工具
适用于 element_getInnerElement 和 element_getInnerElements:
{
"selector": "#my-component",
"targetSelector": ".inner-button"
}
限制说明
page_waitElement 不适用于自定义组件内部元素。请使用 page_waitTimeout 配合元素查询工具进行轮询检查。
自动启动功能(AutoLaunch)
当配置 WEAPP_AUTOLAUNCH=true 时,MCP 服务器可以自动检测并启动微信开发者工具:
- 自动检测端口:检测 9420 端口是否有服务运行
- 无服务则启动:如果端口未占用,自动调用 CLI 启动开发者工具
- 项目选择:
- 如果有默认项目配置,自动使用
- 如果没有默认项目,自动列出最近项目供选择
- 支持输入项目编号(如
1)或完整路径
配置示例
{
"mcpServers": {
"weapp-dev": {
"command": "npx",
"args": ["-y", "weapp-dev-mcp"],
"env": {
"WEAPP_AUTOLAUNCH": "true",
"WEAPP_PROJECT_PATH": "D:\\path\\to\\your\\project"
}
}
}
}
工作流程
- 首次连接时,检测到
WEAPP_AUTOLAUNCH=true
- 检查 9420 端口是否有服务
- 无服务则自动启动开发者工具(使用
cli.bat auto --project <path> --auto-port 9420)
- 等待 45 秒让开发者工具就绪
- 建立 WebSocket 连接
- 后续连接自动复用现有连接
提示:使用 mp_setDefaultProject 设置默认项目后,下次连接无需再次选择项目。
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
如何安裝 Weapp Dev?
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
Weapp Dev 需要 API 金鑰嗎?
這筆記錄未列出必要的環境變數。
Weapp Dev 使用哪種傳輸方式?
Weapp Dev 透過 stdio 在本機執行。
Weapp Dev 上次檢查是什麼時候?
上次檢查時間:2026-10-28。 FastMCP server for automating WeChat Mini Program developer tooling
azure-computeAzure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l 工具
0 / 10