wechat-devtools-mcp 0.1.0

MCP Server for WeChat DevTools CLI - 微信开发者工具 MCP 服务

微信开发者工具 MCP Server

将微信开发者工具 CLI 封装为 MCP (Model Context Protocol) 服务，使编辑器中的 AI 能够直接调用微信 CLI 命令，实现小程序开发、测试、调试、自动化全流程闭环。

参考文档：

• 微信开发者工具 CLI
• 小程序自动化 SDK

---

能力概览

v4.0 — 自动化交互

能力	说明
点击 UI 元素	通过 CSS 选择器模拟 tap 点击任意元素
表单输入	向 input / textarea 输入文本内容
修改页面 Data	动态 setData 热更新 UI，免编译
调用页面方法	远程触发 onPullDownRefresh 等页面方法
获取元素详情	读取元素 text / wxml / style / size / offset
Mock wx API	覆盖 showModal、chooseLocation 等系统调用返回值
调用 wx API	直接执行 wx.setNavigationBarTitle 等接口
页面导航栈	查看完整的页面栈信息

v3.x — 实时调试

💡 核心建议：在排查问题和采集日志时，强烈建议直接使用 wechat_get_cdp_logs获取 CDP 高清日志。

能力	说明
CDP 高清日志	🆕 [推荐] 捕获底层 WXML 警告、网络报错、系统事件和完整堆栈
Console 日志	实时捕获页面层级 console.log/warn/error 输出
异常监控	监听 JS 异常（含完整调用栈）
持久连接	自动化端口一次开启常驻，多工具顺序调用无需重连

---

安装与配置

1. 全局安装 (推荐)

使用 pip 即可直接安装：

pip install wechat-devtools-mcp

或者使用 uvx 直接运行（无需安装）：

uvx wechat-devtools-mcp

2. Node.js 依赖 (自动化功能必需)

部分高级调试功能涉及 miniprogram-automator，安装包后需在对应目录下初始化 Node.js 环境：

# 进入包安装目录下的 scripts 文件夹执行
npm install

3. 编辑器配置

VS Code / Cursor / Claude Desktop

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "wechat-devtools-mcp",
      "env": {
        "WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
        "WECHAT_PROJECT_PATH": "D:\\path\\to\\your\\miniprogram"
      }
    }
  }
}

---

环境变量说明

变量名	说明	默认值	必填
WECHAT_DEVTOOLS_CLI	微信开发者工具 CLI 路径	无	是
WECHAT_PROJECT_PATH	默认小程序项目绝对路径	无	是
WECHAT_CLI_TIMEOUT	CLI 命令超时时间（秒）	60	否
NODE_PATH	Node.js 可执行文件路径	node	否

---

AI 开发工作流指南

1. 理解上下文: wechat_project_info + wechat_read_page
2. 执行修改: (编写代码) -> wechat_compile_check (检查编译)
3. 效果预览: wechat_preview_page
4. 自动化巡检: wechat_auto -> wechat_capture_screenshot -> wechat_get_cdp_logs

---

目录结构 (源码)

wechat-devtools-mcp/
├── pyproject.toml             # Python 项目定义
├── server.json                # MCP Registry 元数据
├── LICENSE                    # MIT 许可证
├── src/
│   └── wechat_devtools_mcp/
│       ├── server.py          # MCP Server 主入口
│       └── scripts/           # Node.js 辅助脚本

许可证

MIT