jshook 的不同之处

大多数面向 JS 分析的 MCP 服务器只暴露少量手写工具，或者只封装一个浏览器引擎。jshook 更接近 面向前端逆向工程的操作系统——36 个自发现域、搜索优先的元工具控制 token 开销、以及能在页面崩溃和会话中断时恢复的运行时：

• 搜索优先、档位可调。 search 档加载约 3K token 的工具元数据；full 档一次性暴露全部 736 个工具，约 109K token（2026-10-10 实测——该值随工具总数增长，工具目录变大后需重新测量）。智能体按任务复杂度逐级提升：search → workflow → full，避免在第一轮就淹没在 schema 海洋里。
• 运行时恢复与会话隔离。 Streamable HTTP 会话在重连后恢复已激活域、浏览器 attach 状态、coverage 状态；浏览器侧会话状态按客户端隔离，两个智能体不会互相踩对方的 CDP 会话。
• 全栈浏览器自动化。 Chromium 与 Camoufox 通过 CDP 控制，内置反检测；显式输入驱动的 CAPTCHA 求解（不内置页面/特征探测）；按需生成自签名 HTTPS 拦截 CA；HTTP/2 帧级构造。
• 真正的逆向工程，不是字符串搜索。 wabt WASM 反汇编（wasm2wat / wasm-decompile / wasm-objdump）、Frida/Ghidra/IDA 桥接、原生 FFI 扫描、硬件断点、PE 内省、GraphQL/Burp Suite 代理桥接、AST 变换——而不是把单条正则塞进工具里。
• 动态可扩展。 热重载插件、声明式工作流、自发现域让服务器不需要重启就能持续生长。

---

能力概览

下面是开箱即用能力的快速扫描。每一行都链向下方的 能力概览。

能力域	亮点
工具档位	search（约 3K token，BM25 + 混合向量排序）· workflow（复合脚本）· full（全部 736 工具）
浏览器自动化	Chromium 与 Camoufox · CDP 附着已有目标 · 反检测预设 · 显式输入 CAPTCHA 求解 · 弹窗、下载、权限、协议拦截器
网络拦截	HTTP/1.1 + HTTP/2 帧级构造 · MITM 代理自动生成 CA · WebSocket 抓包 · GraphQL 自省辅助 · Burp Suite 桥接
JS Hook 与分析	LLM 驱动的反混淆 · 加密逻辑识别 · AST 深度理解 · Source Map 重建 · 脚本提取与回放
WASM 逆向工程	wabt 反汇编 / C 转译（wasm2wat / wasm-decompile / wasm-objdump / wasm2c）· Binaryen wasm-opt · 纯 TS section 解析 · 导入/导出列表 · 按 section 分组的字符串提取（含 name 段函数名恢复）· 函数级二进制 diff · 混淆检测 · 函数级与基本块级插桩
进程与内存取证	原生 FFI 扫描 · 交叉引用图谱 · 硬件断点 · PE 内省 · 活进程附着 · 带区域守卫的内存读写
二进制插桩	Frida 桥接 · Ghidra 与 IDA 桥接 · 系统调用 hook · TLS keylog 与会话分析 · Mojo IPC 分析
Android 与 APK 分析	APK 静态分诊 · manifest 导出与查询 · apktool 反编译/回编 · jadx 反编译与代码检索 · DEX 扫描 · native 库列表 · APK 签名 · unidbg 模拟执行 · 运行时 DEX dump
原生运行时	跨架构样本模拟器 · 平台内省 · Mojo IPC · Dart Inspector · ADB 桥接获取设备流量
编码与变换	URL/Base64/Hex/JWT/Protobuf 编码器 · AST 变换 · 流式解码管线
协同	后台任务队列带进度、取消、异步模式 · 多智能体协同 · 覆盖率报告
Schema 优先元工具	describe_tool · 带参数校验的 call_tool · coverage_report · search_tools
可插拔扩展注册表	热重载插件 · 声明式工作流 · 自发现域

---

典型场景

场景	做法	涉及域
审阅一个压缩后的 bundle	search_tools → deobfuscate → search_in_scripts → understand_code	core
逆向 CAPTCHA 挑战	驱动 Camoufox 页面 → 截图 → 用显式输入求解 → 回放	browser、canvas
抓取并回放 OAuth 流程	proxy_start（自动 CA）→ network_get_requests → graphql_introspect → graphql_replay	proxy、network、graphql
逆向 WASM 加密逻辑	wasm_dump → wasm_disassemble → generate_hooks → memory_breakpoint	wasm、binary-instrument、memory
分诊可疑 APK	apk_static_triage → apk_manifest_dump → jadx_decompile → dex_scan_file	binary-instrument
恢复中断的浏览器会话	重连 Streamable HTTP → 恢复已激活域与浏览器状态	browser、coordination
审计 Node 进程中的凭据	process_list → memory_scan_filtered → binary_strings_extract	process、memory、binary-instrument
构建自定义工作流	list_extension_workflows → run_extension_workflow	workflow、extension-registry
Hook 活进程里的函数	frida_spawn → frida_attach_interceptor → frida_run_script → frida_enumerate_functions	binary-instrument

---

快速接入

无需全局安装，添加到 MCP 客户端配置即可使用。

Claude Desktop / Cursor（claude_desktop_config.json）：

{
  "mcpServers": {
    "jshook": {
      "command": "npx",
      "args": ["-y", "@jshookmcp/jshook@latest"],
      "env": {
        "MCP_TOOL_PROFILE": "search",
        "npm_config_omit": "optional"
      }
    }
  }
}

（Windows 用户：若找不到 npx，请使用 npx.cmd 绝对路径。）

该轻量配置会跳过可选的 ONNX、Z3、Binaryen、Camoufox 和 Playwright 包；需要这些完整档 运行时，移除 npm_config_omit。

多个 Agent 共用一个本地进程

默认 stdio 配置会让每个 MCP 宿主启动一份完整的 jshook。若要共享 embedding 模型、浏览器运行时和缓存，可以启动一个本地 Streamable HTTP daemon：

pnpm build
pnpm daemon

向量搜索在所有传输下默认开启：轻量静态模型，工具目录 embedding 落盘缓存，按需加载、空闲释放。只需词法搜索时可设置 SEARCH_VECTOR_ENABLED=false。

然后在各 MCP 客户端的 HTTP/URL server 配置中统一指向 http://127.0.0.1:3000/mcp。每个客户端拥有独立的 MCP 会话和响应路由，重量级运行时资源只保留一份。建议保持默认的本机回环监听；如需对外暴露，必须先设置 MCP_AUTH_TOKEN。

随任务复杂度逐级提升档位

{
  "env": {
    "MCP_TOOL_PROFILE": "search"     // 从这里开始，约 3K token 元数据
  }
}

开始组合复合脚本时把 MCP_TOOL_PROFILE 切到 workflow；需要所有工具时切到 full。coverage_report 可随时查询当前激活集。

---

亮点

• 档位阶梯。 从 search（约 3K token 元数据）起步；组合复合脚本时切到 workflow；确实需要全部工具才升到 full。coverage_report 随时告诉你现在激活的是什么。
• 元工具。 describe_tool 返回 JSON Schema；call_tool 在调用前校验参数；每个工具都带 readOnlyHint / destructiveHint / idempotentHint / openWorldHint。
• 浏览器自动化。 Chromium 与 Camoufox 走 CDP，可附着已有目标，反检测预设，弹窗/下载/权限拦截器，显式输入 CAPTCHA 求解，三种文档时机的 JS/CSS 注入，coverage 跨重连持久化。
• 网络拦截。 自动生成 HTTPS 拦截 CA、HTTP/1.1 + HTTP/2 帧级构造、WebSocket 抓包、GraphQL 辅助、Burp Suite 桥接——同一套 MCP 工具面。
• 逆向工程。 wabt WASM 反汇编（wasm2wat / wasm-decompile / wasm-objdump）与 Binaryen wasm-opt、Frida/Ghidra/IDA 桥接、硬件断点、原生 FFI 扫描、PE 内省、系统调用 hook、AST 变换、Source Map 重建。
• 会话恢复。 Streamable HTTP 传输在重连后恢复已激活域、浏览器 attach 状态、coverage 状态；浏览器侧会话按客户端隔离。
• 插件和工作流。 放进目录即获得一个域；写一段 YAML 就能当一个工具跑；注册表自发现。

---

传输与部署

服务器开箱支持两种传输。

传输	何时使用	说明
stdio	Claude Desktop、Cursor 等单宿主客户端默认	每个 MCP 宿主一个完整进程；建议使用轻量档位
Streamable HTTP	多个智能体共享 embedding 模型、浏览器运行时和缓存	默认本机回环监听；对外暴露前必须设置 MCP_AUTH_TOKEN

两种传输暴露相同的工具面。coverage_report 展示每个会话已激活的域——长运行会话在重连后恢复浏览器 attach 状态、coverage 状态与工具激活。

生产部署请参考 安全与生产指南。

---

最近运行时变更

• HTTP 传输现在支持多路复用独立 MCP 会话，并在重连后恢复运行时状态。
• proxy_start 在需要时会自动生成本地 HTTPS 拦截 CA。
• Browser 域的 CAPTCHA 求解已改为显式参数驱动：按需传入 taskKind、siteKey、imageBase64、callbackName、responseSelector。不会再内置页面/组件特征探测。

---

注册表快照

下面的内置能力快照由运行时 registry 动态生成，并在 CI 中校验。

• 包版本：0.4.3
• 内置工具数：736
• 域列表：adb-bridge, binary-instrument, browser, canvas, coordination, core, cross-domain, dart-inspector, debugger, encoding, exploit-dev, extension-registry, graphql, instrumentation, maintenance, memory, mojo-ipc, native-bridge, native-emulator, network, platform, process, protocol-analysis, proxy, session, sourcemap, streaming, syscall-hook, tasks, tls-inspector, trace, transform, v8-inspector, wasm, webgpu, workflow
• 说明：以上数据由运行时 registry 动态生成，不要手改计数。

查看完整工具参考 ↗

---

架构

• 运行时注册表 — 域通过 manifest.ts 自发现；新增域只需创建一个文件。
• 延迟初始化 — Handler 在首次调用时实例化，而非启动时预加载。
• BM25 + 向量搜索 — search_tools 混合排序 + 自适应权重。
• MCP ToolAnnotations — 每个工具携带 readOnlyHint / destructiveHint / idempotentHint / openWorldHint。
• 档位阶梯 — search（约 3K token）→ workflow（复合脚本）→ full（全部 736 工具）。
• 传输对称 — stdio 与 Streamable HTTP 暴露相同工具面；按客户端隔离会话。

详见 架构指南 与 配置参考。

---

从源码构建

环境要求：Node.js 22.22.2+、pnpm 10.x。

pnpm install
pnpm build
pnpm start           # 从 dist/ 启动构建后的服务
pnpm dev             # tsx watch 模式从源码启动
pnpm check           # 漂移守卫（metadata + openapi + 域完整性 + 事件契约）+ lint + format check + typecheck + 单元测试
pnpm test            # Vitest 单元套件
pnpm test:e2e        # 浏览器/工具端到端套件
pnpm daemon          # 构建后启动 Streamable HTTP daemon

原生辅助库通过 pnpm build 一并打包；首次运行时服务会按档位下载可选运行时 （ONNX、Z3、Binaryen、Camoufox、Playwright）。

---

项目统计

---

许可证

AGPLv3。