基于 FastMCP 的服务器,通过 miniprogram-automator 自动化微信开发者工具。该服务器提供 MCP 工具,让 AI 助手能够导航、检查和操作小程序页面——类似于 playwright-mcp,但专为微信生态系统定制。

⚠️ 官方已下场:建议迁移到微信开发者工具 スキル

微信官方已正式推出「微信开发者工具 Skill」並开启公测,可在 Cursor / Claude 等 AI Agent 环境中直接操作开发者工具:打开项目、编译、模拟器、日志排查、预览上传、云开发等,无需在 IDE 与开发者工具之间反复横跳。

为什么建议迁移？

• 官方维护与版本同步:Skill 随开发者工具 Nightly 发布,与工具能力对齐,不必再维护一套第三方 MCP。
• 覆盖面更广：不止页面自动化，还包括项目导入、编译构建、真机预览、上传、云环境等。
• より贴近真实工作流:Agent 可直接驱动开发者工具完成「写代码 → 編译 → 看模拟器 / 日志 → 预览」閉環。

官方接入（两步）

1. 升级开发者工具 ダウンロード Nightly Electron Build 2.02.2607032 及以上。

2. 安装 Skill(二选一)

• 命令行(推薦):终端执行 wechatide,把输出的 Skill 目录交给你的 AI Agent 安装。
• 图形界面:开发者工具菜单 → 「导出开发者工具 Skill」 → 导入到 Agent。

macOS 上 Skill 常见路径示例:

调用示例(具体以 wechatide / Skill 文档为准):

相关链接

• 公測公告:微信开发者工具 Skill 開启公测啦!
• 场景与使用细节：见公告中的官方文档入口；本地以开发者工具内置 miniprogram-dev-skill 的 SKILL.md 为准。

---

前置要求

• 已安装微信开发者工具,支持命令行访问([cli / cli.bat)
• 本地已安装 Node.js 18+ 和 npm
• 有可以在开发者工具中打开的小程序项目

快速開始(npm 包)

@yfme/weapp-dev-mcp 已发布到 npm,普通使用者无需克隆仓库或手动执行 node dist/index.js。

使用 NPX 运行

安装到项目/全局

或作为项目依赖：

只有在本仓库内开发时，才建议直接运行 node dist/index.js。一般用户请按照以上 npm 包方式启动。

MCP 客户端集成

配置

微信小程序 MCP 服务器

基于 FastMCP 的服务器，通过 miniprogram-automator 自动化微信开发者工具。该服务器提供 MCP 工具，让 AI 助手能够导航、检查和操作小程序页面——类似于 playwright-mcp，但专为微信生态系统定制。

⚠️ 官方已下场：建议迁移到微信开发者工具 Skill

微信官方已正式推出「微信开发者工具 Skill」并开启公测，可在 Cursor / Claude 等 AI Agent 环境中直接操作开发者工具：打开项目、编译、模拟器、日志排查、预览上传、云开发等，无需在 IDE 与开发者工具之间反复横跳。

为什么建议迁移？

• 官方维护与版本同步：Skill 随开发者工具 Nightly 发布，与工具能力对齐，不必再维护一套第三方 MCP。
• 覆盖面更广：不止页面自动化，还包括项目导入、编译构建、真机预览、上传、云环境等。
• 更贴近真实工作流：Agent 可直接驱动开发者工具完成「写代码 → 编译 → 看模拟器 / 日志 → 预览」闭环。

官方接入（两步）

1. 升级开发者工具
   下载 Nightly Electron Build 2.02.2607032 及以上。

2. 安装 Skill（二选一）

   • 命令行（推荐）：终端执行 wechatide，把输出的 Skill 目录交给你的 AI Agent 安装。
   • 图形界面：开发者工具菜单 → 「导出开发者工具 Skill」 → 导入到 Agent。

macOS 上 Skill 常见路径示例：

/Applications/wechatwebdevtools.app/Contents/Resources/app.asar.unpacked/miniprogram-dev-skill

调用示例（具体以 wechatide / Skill 文档为准）：

wechatide                                    # 查看 Skill 路径与可用工具
wechatide -c Cursor -t check_devtools_status # 检查登录与环境

相关链接

• 公测公告：微信开发者工具 Skill 开启公测啦！
• 场景与使用细节：见公告中的官方文档入口；本地以开发者工具内置 miniprogram-dev-skill 的 SKILL.md 为准。

---

前置要求

• 已安装微信开发者工具，支持命令行访问（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",