wechat-dev-mcp

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

让任意 AI 客户端自动调试微信小程序/小游戏:截图、模拟触控、读日志、一键重开;配合 wechat-dev-skill 自动巡检四来源报错。

README.md

npm version node license

微信开发者工具 MCP

用大白话让 AI 帮你调试微信小程序 / 小游戏。

🇺🇸 English · 🇨🇳 中文


你只要对 AI 说人话,剩下的它自己连、自己查报错、自己截图验证:

🗣️ 「打开我的小程序 → 跳到首页 → 点登录按钮 → 截图看效果」

🎮 「打开小游戏 → 在第 2 行第 10 列落子 → 截张图 → 导出日志」

兼容 WorkBuddy、Claude Code、Cursor、Cline、Zed 等任意 MCP 客户端。


🚀 3 步上手

1. 安装

npx -y wechat-dev-mcp

2. 接进你的客户端(命令都一样,只差配置文件位置)

以 Cursor 为例,编辑 ~/.cursor/mcp.json

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "npx",
      "args": ["-y", "wechat-dev-mcp"]
    }
  }
}

仓库已附带 .cursor/mcp.json / .mcp.json,也可直接用 examples/cursor-mcp-config.json。其它客户端(Claude Code / Desktop、Codex、Windsurf、Cline、Zed)配置方式见各自文档,命令相同。

3. 开干 —— 直接用自然语言跟 AI 说

「帮我打开 /Users/你/项目 这个小程序,跳到首页,点登录,然后截图给我看」

就这么简单。


✅ 准备工作(一次就好)

  • 装好 微信开发者工具,并开启服务端口设置 → 安全设置 → 服务端口
  • 本机 Node.js ≥ 18

⚠️ 没开「服务端口」会报 Connection refused


🧩 配套 Skill(可选,但推荐)

wechat-dev-skill 把"扫 build / devtools / output / networks 四来源报错"做成一句话流程。装上后直接对 AI 说「调试一下这个项目」即可,它会自动定位报错。


🛠 能做什么(节选)

  • 📸 截图:小程序页面 / 小游戏画布实时截图
  • 👆 触控:模拟点击、长按、滑动(小游戏落子自动坐标补偿,落点精准)
  • 📜 读日志:console / vConsole / 网络请求,定位报错
  • 🔄 重开:一键重开并重新编译(不用易崩的 Page.reload
  • 🧪 功能验证:自动连模拟器、跑流程、核对 UI

小游戏完整文档见 docs/MINIGAME_GUIDE.md


❓ 常见问题

问题 解决
Connection refused 开发者工具在跑 + 「服务端口」已开
小游戏点不动 先让游戏进入可交互界面(如说"开始游戏"),再让 AI 触控
落子位置偏了 game_tap_grid(已含补偿);仍偏再标定
游戏卡死 让 AI 用 restart_project 重开,Page.reload

MIT License © CuiJiawei · 欢迎 Issue / PR

Yorumlar (0)

Sonuc bulunamadi