用途:通过 MCP 协议调用微信开发者工具 CLI,实现小程序编译、预览、上传、页面导航、元素交互、数据读取、日志排查与自动化测试。
安装与配置:pip install uv;uv tool install wechat-devtools-mcp --force。在 MCP 配置中注册名使用 wechat-devtools-mcp,command 为 uvx,args 为 wechat-devtools-mcp,env 需设置 WECHAT_DEVTOOLS_CLI(如 Windows 的 cli.bat 或 macOS 的 /Applications/wechatwebdevtools.app/Contents/MacOS/cli)与 WECHAT_PROJECT_PATH(须指向含 project.config.json 的根目录)。必须在开发者工具中开启服务端口,否则 CLI 操作会报 CLI_TIMEOUT。
主要能力:wechat_ide 负责 open/login/close/status 等环境操作;wechat_build 负责 compile/preview/upload/build_npm/cache_clean;wechat_automator 提供 start、tap、input、element_info、set_data、call_method、call_wx、mock_wx、evaluate、page_stack、page_data、system_info、storage;wechat_inspector 通过 CDP 或 automator 采集日志;wechat_screenshot 支持长图拼接;wechat_navigate 处理页面跳转;wechat_file 读取项目信息与源码。
使用方式:先 status 检查环境(CLI、服务端口、项目路径、Node、登录态、版本一致性),再 open、automator start、compile、page_data 建立基线。改代码后只需 compile 再 page_data,无需重新 open。页面跳转可用 wx.navigateTo 或 reLaunch,tabBar 页用 switchTab。evaluate 推荐传完整函数源码 fn_source 并显式 return。
限制:automator 端口 9420 独占,同一时刻只能一个 agent 操作;Mock 仅当前会话有效;scroll-view 页面长图可能只截到视口;固定头尾可能造成内容缺失;官方 2.x 内建 MCP 存在时基础操作可交给官方工具,长图拼接与 CDP 结构化日志等由本 skill 承接;未提供收费与价格信息。