MCP & Skill
- MCP 是工具本身:AI 通过它直接操作手机上的 WeAppDev。
- Skill 是用法说明书:装上后 AI 自动知道什么场景调哪个
wad_*工具、参数怎么给。
一键安装
不知道怎么装?把下面这段话原样发给你的 AI 助手,它会读完这篇文档后,自动把 MCP 和 Skill 装到你当前的 AI 工具里:
text
请查看 https://weappdev.top/ai 帮用户安装好 MCP 以及 Skill 到用户当前的 AI 工具中
并且根据文档,给用户介绍清楚,让用户考虑使用 Studio MCP,还是直接使用直连 MCP
如果无法安装,请告诉用户如何配置 MCP/Skill 到当前 AI 工具中装好后对 AI 说一句「用 wad_status 看看设备状态」,能直接调用即为成功。
Skill
安装(三选一)
bash
# 方式一:skills CLI 安装(推荐)
npx -y skills add RYF5584/weappdev-skill
# 方式二:官网下载 ZIP 手动导入
# 下载并解压 https://weappdev.top/downloads/weappdev-skill.zip
# 得到 weappdev/ 目录,放进客户端 skills 目录(如 ~/.claude/skills)
# 方式三:skills CLI 从官网安装
npx -y skills add https://weappdev.top --skill weappdev- Claude Code 等支持 Agent Skills 的客户端:放入
~/.claude/skills/(项目级放.claude/skills/),重启会话生效 - 其他 AI 客户端:把 skill 目录交给任何支持
SKILL.md规范的加载器;没有加载器时,把SKILL.md内容贴进系统提示也能用
内容概览(覆盖范围)
| 覆盖 | 场景 |
|---|---|
| 连接与设备 | 直连 / 聚合判别、多设备选择、连不上排查 |
| 逆向 | 定位接口 → 断点 → 求值 → 还原算法 |
| 调试与自动化 | 断点单步、快照点击填写截图、等待与元素操作 |
| 网络 | 抓包、重放、改写、WebSocket |
| 云开发 | 来源判别、V3 解密、纯协议直发 |
| Native / 插件 / 文件 | JSAPI 记录、插件全生命周期、文件与存储 |
| 参考 | 全部 wad_* 工具参数表、完整实例、辅助脚本 |
MCP
安装(二选一)
方式一 · 直连 HTTP —— 单设备、零安装;手机本机里的 AI 客户端只能用这种:
json
{
"mcpServers": {
"weappdev-http": {
"type": "http",
"url": "http://127.0.0.1:9400/mcp"
}
}
}USB 调试先执行 adb forward tcp:9400 tcp:9400;局域网把 127.0.0.1 换成设备 IP。
方式二 · Studio 聚合 —— 多台设备自动发现、统一管理:
json
{
"mcpServers": {
"weappdev": {
"command": "npx",
"args": ["-y", "@ryf5584/weappdev-mcp"]
}
}
}端口说明
9400 是默认端口,被占用时网关自动顺延,实际端口以设备 /v1/status 返回的 gateway.port 为准。
内容概览
| 分组 | 能力 |
|---|---|
| core | 状态总览、打开小程序、快照点击填写截图、批量调用 |
| reverse | 脚本检索、API 雷达、断点单步、WebSocket、hooks |
| debug / render | 调试器、DOM、交互模拟 |
| network / cloud | 抓包重放、云开发直发与凭证 |
| native / plugins / files | Native 记录、插件管理、文件与存储 |