一句话看懂：开发者 JustHappy 在 vConsole 的 dev 分支中加入 MCP 面板，并配套做了 vConsole-MCP 服务，让 Codex、Claude Code 等 AI 编程工具能直接读取手机 H5 页面的 Console 日志、Fetch/XHR 请求，在用户授权后还能执行 JavaScript，省去截图和手工复述。
事件核心：发生了什么
跨端 H5 开发者长期面对安卓、iOS、鸿蒙以及各家小程序 WebView 环境不一致的问题，腾讯开源的 vConsole 是常用的真机调试面板。但把 vConsole 里的报错交给 AI 分析，通常要走“截图、复制日志、口头描述”的流程。作者 JustHappy 的做法是给 vConsole 增加一个 MCP 面板，配合独立的 vConsole-MCP 服务，通过 WebSocket 把手机页面和本机 AI Agent 连接起来。
目前该服务向 Agent 开放四个工具：list_pages 列出已连接的 H5 页面，包含页面 ID、URL、标题、User-Agent 和连接时间；get_console_logs 读取 Log、Info、Debug、Warn、Error，并支持按级别和数量筛选；get_network_requests 读取 vConsole 捕获的 Fetch/XHR 记录，可按失败状态或 URL 关键字过滤，查看状态码、耗时、请求与响应头，按需读取 body；execute_javascript 在手机用户明确授权后执行脚本。使用需拉取 Simonmie/vConsole 的 dev 分支自行构建，并在 Codex 或 Claude Code 中通过命令注册 MCP 服务，手机端填写电脑局域网 IP、端口 8765 和配对 Token 后连接。项目要求 Node.js 20 及以上，尚未发布 npm 包。
为什么重要
当前 AI 编程工具的能力瓶颈不在推理，而在“上下文获取”。vConsole-MCP 把手机页面的现场数据变成 Agent 可直接调用的工具接口，等于给 AI 补上了一双能看见真机运行状态的眼睛。它选择 MCP 作为接入方式，说明这套由 Anthropic 推动的协议正在从桌面 IDE 向移动端调试场景延伸，工具链的边界被继续拉开。更值得注意的是权限设计：读取日志和网络请求默认开放，执行 JavaScript 必须由手机用户手动勾选，且页面刷新后授权失效。这种“读放开、写收紧”的分层方式，为 AI Agent 接触真实生产环境提供了一个克制的样本。
对用户/开发者/创作者的影响
对跨端 H5 开发者来说，调试路径会明显缩短：发现接口报错后，可以直接让 Agent 读取错误日志和失败请求，根据 URL、状态码、Headers 和响应内容定位问题，不必再手工搬运信息。但它不是系统级抓包工具，只覆盖 vConsole 已捕获的 Fetch/XHR，不读取原始 WebSocket 帧，也不分析其他 App 的流量。HTTPS 页面通常无法直接连明文的 ws://，需要额外配置可信的 wss:// 服务。安全方面，配对 Token 只能防止局域网内页面随意接入，并不等于完整加密和身份认证，服务端口不建议暴露到公网，JavaScript 执行权限也应只在可信开发页面开启。
AI 工具推荐
想把多个 AI 模型放在一个入口？
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。
推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。
值得关注的后续
一是官方 vConsole 是否会接纳或合并 MCP 面板，否则开发者需要长期维护 dev 分支。二是项目何时以 npm 包形式发布，降低源码构建门槛。三是连接稳定性和 HTTPS/wss 方案能否补齐，以及是否会出现同类工具跟进 MCP 接入。这些将决定它停留在个人工具，还是成为跨端调试的常规配置。
来源：juejin
