SuperAPI AI 工具集

wechat-devtools-mcp

编程与开发

查看项目

更新于 10-16 01:06

技能介绍

用途:把微信开发者工具 CLI 包装成 MCP 服务器,使 AI 编码代理能程序化控制微信 IDE,覆盖小程序从开发到部署的完整生命周期。架构为「薄 MCP(7 个工具)+ 厚 Skill(SOP、参数参考、护栏)」,Skill 为必需项,缺少它代理无法正确执行标准工作流。

主要能力:wechat_ide 管理 IDE 生命周期(open、login、is_login、close、quit、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 抓取运行时日志(console、cdp);wechat_screenshot 截图(支持整页与指定元素,返回 base64 PNG);wechat_navigate 导航并捕获 CDP 日志;wechat_file 做项目内省(project_info、list_pages、read_page、read_file)。

使用方式:先安装 uv 并执行 uv tool install wechat-devtools-mcp --force;在微信开发者工具中开启「设置 → 安全 → 服务端口」;在 MCP 客户端配置 uvx wechat-devtools-mcp,并设置环境变量 WECHAT_DEVTOOLS_CLI(CLI 绝对路径)与 WECHAT_PROJECT_PATH(项目根目录);再安装 Skill(如 npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools)。

适用场景:UI 调试、错误排查、整页健康检查、基于 mock 的集成测试、部署发布、页面参数发现等。

限制:需先启用 IDE 服务端口,否则连接被拒;自动化命令可能因页面未加载或选择器无效而超时;截图可能因渲染未完成或 IDE 最小化而空白;mock 需 API 名精确且时机正确;文件路径须相对项目根且用正斜杠。版本要求 MCP Server v0.9.7+、微信开发者工具 1.06.2302270+、Python 3.8+、Node.js 14+。