본프로젝트는 本地 Streamable HTTP MCP Server,用于把 WMPFDebugger 暴露的裸 Chrome DevTools Protocol WebSocket 포장成 MCP 도구,辅助 Codex / Cursor / VS Code Agent 对已授权调试的微信小程序进行安全评估、证据采集和报告整理。

使用边界

• 仅用于已获得授权的小程序、本机调试环境和当前 WMPFDebugger 会话.
• MCP HTTP 서비스只监听 127.0.0.1
• 默认只连接 ws://127.0.0.1:62000,CDP URL 只允许 127.0.0.1 或 localhost
• /mcp 必须携带启动时输出的 token.
• 主动请求修改/重放能力未实现；当前工具只做被动采集、单次页面交互观察和人工验证计划生成。
• 点击类工具会拦截支付、提交订单、删除、注销、退款、提现、确认支付等危险文本，默认不执行，必须显式 requireConfirm=true。

安装与启动

也可以指定固定 토큰:

启动后访问根路径查看当前 MCP URL:

默认 MCP URL:

코덱스 배치

建议测试提示词

에이전트 도구발견

MCP 초기 화响应包含 서버 전체 instructions Codex 看到 wmpf、wmpf-mcp、WMPFDebugger, 微信小程序调试/逆向/安全评估时,应直接调用 wmpf_start,不需要先手工枚举 CDP Target 或逐个查找底层工具。

wmpf_start 是稳定的单入口,会完成:

1. 连接本地 CDP WebSocket.
2. 启用 Runtime 和 Network.
3. 자동 선택 appservice execution context.
4. 注入 wx.request, fetch 和 XHR 被动 hook.
5. 返回页面快照和推荐的下一步工具。

만약 客户端把部分 MCP 도구지연 加载,Agent 应使用 tool search 查询 wmpf 핵심 工作流不再依赖 Agent 自己猜测入口.

工具列表

基础连接与 CDP

• wmpf_start:首选单入口. 遇到 wmpf 相关任务时优先调用,自动连接、选择 appservice、安装 hook,并返回下一步建议。
• status:查看 MCP 和 CDP 连接状态.
• connect_wmpf:连接本机 WMPFDebugger CDP WebSocket,并启用 Runtime/Network.

wmpf-mcp-bridge

本项目是一个本地 Streamable HTTP MCP Server，用于把 WMPFDebugger 暴露的裸 Chrome DevTools Protocol WebSocket 包装成 MCP 工具，辅助 Codex / Cursor / VS Code Agent 对已授权调试的微信小程序进行安全评估、证据采集和报告整理。

使用边界

• 仅用于已获得授权的小程序、本机调试环境和当前 WMPFDebugger 会话。
• MCP HTTP 服务只监听 127.0.0.1。
• 默认只连接 ws://127.0.0.1:62000，CDP URL 只允许 127.0.0.1 或 localhost。
• /mcp 必须携带启动时输出的 token。
• 主动请求修改/重放能力未实现；当前工具只做被动采集、单次页面交互观察和人工验证计划生成。
• 点击类工具会拦截支付、提交订单、删除、注销、退款、提现、确认支付等危险文本，默认不执行，必须显式 requireConfirm=true。

安装与启动

npm install
npm run dev

也可以指定固定 token：

$env:MCP_TOKEN="your-local-token"
npm run dev

启动后访问根路径查看当前 MCP URL：

http://127.0.0.1:43827/

默认 MCP URL：

http://127.0.0.1:43827/mcp?token=wmpf-local-token

Codex 配置

[mcp_servers.wmpf]
enabled = true
url = "http://127.0.0.1:43827/mcp?token=wmpf-local-token"
startup_timeout_sec = 20
tool_timeout_sec = 60

建议测试提示词

使用 wmpf MCP，先调用 wmpf_start。它会连接 ws://127.0.0.1:62000、选择 appservice context，并安装 wx.request/fetch/XHR 被动 hook。
随后打开当前小程序页面并操作关键业务流程。
再调用 dump_runtime_snapshot、get_all_requests、get_api_inventory、analyze_auth_surface、find_idor_candidates、find_sensitive_data_exposure、find_upload_surfaces、find_payment_and_order_surfaces、find_sign_related_requests。
请基于证据生成 generate_security_notes，只输出发现线索和人工验证建议，不直接下漏洞结论。

Agent 工具发现

MCP 初始化响应包含 server-wide instructions。Codex 看到 wmpf、wmpf-mcp、WMPFDebugger、微信小程序调试/逆向/安全评估时，应直接调用 wmpf_start，不需要先手工枚举 CDP Target 或逐个查找底层工具。

wmpf_start 是稳定的单入口，会完成：

1. 连接本地 CDP WebSocket。
2. 启用 Runtime 和 Network。
3. 自动选择 appservice execution context。
4. 注入 wx.request、fetch 和 XHR 被动 hook。
5. 返回页面快照和推荐的下一步工具。

如果客户端把部分 MCP 工具延迟加载，Agent 应使用 tool search 查询 wmpf 。核心工作流不再依赖 Agent 自己猜测入口。

工具列表

基础连接与 CDP

• wmpf_start：首选单入口。遇到 wmpf 相关任务时优先调用，自动连接、选择 appservice、安装 hook，并返回下一步建议。
• status：查看 MCP 和 CDP 连接状态。
• connect_wmpf：连接本机 WMPFDebugger CDP WebSocket，并启用 Runtime/Network。
• select_appservice_context：自动枚举 Target、flatten attach，并选择包含 wx.request / require / getCurrentPages 的 appservice Runtime context。
• cdp_call：调用任意 CDP 方法，支持传入 flatten sessionId。
• cdp_call_target：对指定 targetId 自动 Target.attachToTarget({ flatten: true }) 后在子 session 中调用 CDP。
• runtime_eval：在当前 Runtime 执行 JS。
• runtime_eval_appservice：在自动选择的 appservice Runtime context 中执行 JS。
• network_enable：启用 CDP Network。
• get_recent_requests：读取最近 CDP Network 请求，支持 domain、pathPrefix、keyword、excludeStatic、compact 过滤。
• get_response_body：尝试读取 CDP 响应体。
• get_recent_console：读取 console 和 exception 事件。

运行时与页面探索

• dump_runtime_snapshot：采集页面运行时快照、storage 摘要、可见文本、可交互元素、疑似框架对象。
• get_basic_page_info：兼容旧版页面信息工具。