Servidor MCP Weapp Dev | PlugMCP
Pular para o conteúdo Do publicador
Documentação 微信小程序 MCP 服务器
基于 FastMCP 的服务器,通过 miniprogram-automator 自动化微信开发者工具。该服务器提供 MCP 工具,让 AI 助手能够导航、检查和操作小程序页面——类似于 playwright-mcp,但专为微信生态系统定制。
⚠️ 官方已下场:建议迁移到微信开发者工具 Skill
微信官方已正式推出「微信开发者工具 Skill」并开启公测 ,可在 Cursor / Claude 等 AI Agent 环境中直接操作开发者工具:打开项目、编译、模拟器、日志排查、预览上传、云开发等,无需在 IDE 与开发者工具之间反复横跳。
FastMCP server for automating WeChat Mini Program developer tooling
Conecte qualquer ferramenta a qualquer agente. Diretório MCP para quem não escreve servidores.
Produto
Diretório
Desenvolvedores
Empresa
—
为什么建议迁移?
官方维护与版本同步 :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 设置默认项目后,下次连接无需再次选择项目。
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas Como instalo Weapp Dev? Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Weapp Dev precisa de uma chave de API? Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Weapp Dev usa? Weapp Dev roda localmente via stdio.
Quando Weapp Dev foi verificado pela última vez? Última verificação: 2026-10-28. FastMCP server for automating WeChat Mini Program developer tooling
azure-compute Azure 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 As ferramentas têm descrição 0 de 6