vconsole-mcp Skill 技能

技能简介

vconsole-mcp 是一个 MCP 服务器，把手机 H5 页面 vConsole 面板的 console 日志与网络请求暴露给 Codex、Claude Code 等 MCP 客户端，并在用户明确授权下提供受控的 JavaScript 执行能力。注意：腾讯官方 vConsole 并不提供 MCP 连接能力，需配合作者分叉的 Simonmie/vConsole dev 分支（含中文文档）使用。

核心能力

1. list_pages：列出当前已连接的移动页面；

2. get_console_logs：按级别过滤最近的 console 记录；

3. get_network_requests：按失败状态、URL、请求体与数量过滤读取网络记录；

4. execute_javascript：在指定 pageId 页经 runtime.evaluate 执行至多 10 万字符 JS，超时 100~30000ms 可配（默认 8000）；

5. 安全约束：前三个只读；execute_javascript 可能有破坏性，须在面板显式开启后才生效，刷新即重置；

6. 配对令牌：可选 token，防止其他页面注册进本地桥接。

安装配置

1. 源码构建：仓库内 pnpm install && pnpm build 产出 dist/index.js；

2. MCP 注册：codex mcp add vconsole -- node /dist/index.js（claude 同理）；或 npx -y vconsole-mcp；

3. 参数与环境变量：--host/--port 可配（默认 0.0.0.0:8765），对应 VCONSOLE_MCP_HOST/PORT/TOKEN；启用令牌时两端写同一 token。

使用步骤

1. 构建并启动：对上走 stdio，启动日志写 stderr，不污染传输；

2. 在 Codex / Claude Code 注册并连接（8765 单进程占用，并用需分端口）；

3. 移动端初始化分叉版 vConsole：endpoint 指向电脑 IP 的 ws 地址，配置 token/autoConnect，JS 执行默认关闭；

4. 先 list_pages 获取页面，再读日志与网络记录；执行 JS 前先在面板授权，带 pageId 调 execute_javascript。

适用场景

1. 真机 H5 调试：页面与桌面浏览器隔离时，把日志拉到开发机；

2. AI 排查：console 与接口报错喂给编码智能体，会话式定位线上问题；

3. 自动化测试：Agent 读取日志与网络记录做断言与回归；

4. 性能诊断：检视请求时序、失败请求与运行时异常。

适用人群

移动端 H5 前端、端到端自动化测试工程师，以及把 Codex / Claude Code 接入调试流程的 AI 开发者。

工作原理

进程对上用 stdio 与智能体对话，对下在 8765 端口监听 vConsole 分叉版的 WebSocket 注册；日志与网络记录留在手机页面 store 中按需拉取，桥接无需数据库或云服务；写操作经面板显式授权才由 runtime.evaluate 下发，形成"读默认开放、写必须人批"的安全模型。

官方链接

https://github.com/Simonmie/vConsole-MCP