zhizhuodemao/js-reverse-mcp

为 AI Agent 设计的 JS 逆向 MCP Server，内置反检测，基于 chrome-devtools-mcp 重构 | JS reverse engineering MCP server with agent-first tool design and built-in anti-detection. Rebuilt from chrome-devtools-mcp.

GAI 中文摘要

js-reverse-mcp 是一个专为 AI Agent 设计的 JavaScript 逆向工程 MCP 服务器，它通过深度集成的浏览器调试能力，赋能 AI 辅助分析和破解复杂的网页代码。该项目基于 Patchright 重构，通过内置的双层反检测机制，能够模拟真实的浏览器行为并维持持久化登录态。

该工具支持有头模式下的实时断点调试与调用栈分析，并具备完善的 JavaScript 脚本提取、搜索及源码保存功能。它通过协议层与源码层的双重优化规避自动化检测，无需通过 JS 注入进行篡改，极大降低了被反爬机制拦截的风险。此外，它还提供了对 XHR 请求、WebSocket 消息以及运行时变量检查的深度监控能力。

本项目主要适用于需要进行网页逆向分析、爬虫开发以及复杂前端逻辑调试的开发者，特别是在面对强反爬、高等级指纹检测的站点时，可作为 Claude、Cursor 或 Copilot 等 AI 编码助手的强力辅助工具。

⭐

1.6k

Stars

🔱

231

Forks

👁

Watchers

📋

Issues

TypeScriptApache-2.0创建于 2025/11/29更新于今天

在 GitHub 上查看

README

由 Gemini 翻译整理

JS Reverse MCP

English | 中文

JavaScript 逆向工程 MCP 服务器，让你的 AI 编码助手（如 Claude、Cursor、Copilot）能够调试和分析网页中的 JavaScript 代码。

基于 Patchright 协议层反检测，对强反爬站点可选启用 CloakBrowser 源码层指纹模式。有头模式 + 持久化登录态 + 零 JS 注入 —— 看起来、行为都像一个真实的 Chrome。

功能特点

默认有头调试：看得到浏览器，下断点、单步、看调用栈 —— 真正的逆向流程
持久化登录态：cookies / localStorage 跨会话保留
双层反检测：Patchright 在 CDP 协议层规避 Runtime.enable、Console.enable 等泄露点；可选 --cloak 启用 CloakBrowser 二进制，再加 49 个 C++ 源码层指纹 patch（canvas / WebGL / audio / GPU / 字体）
脚本分析：列出所有加载的 JS，搜索代码，获取/保存源码
断点调试：设置/移除断点，支持条件断点，压缩代码中精确定位
执行控制：暂停/恢复，单步 over/into/out，响应带源码上下文
运行时检查：在断点处求值，检查作用域变量
网络分析：请求调用栈、XHR 断点、WebSocket 消息分析

系统要求

Node.js v20.19 或更新版本
Chrome 稳定版

快速开始（npx）

无需安装，直接在 MCP 客户端配置中添加：

{
  "mcpServers": {
    "js-reverse": {
      "command": "npx",
      "args": ["js-reverse-mcp"]
    }
  }
}

Claude Code

claude mcp add js-reverse npx js-reverse-mcp

Codex

codex mcp add js-reverse -- npx js-reverse-mcp

Cursor

进入 Cursor Settings -> MCP -> New MCP Server，使用上面的配置。

VS Code Copilot

code --add-mcp '{"name":"js-reverse","command":"npx","args":["js-reverse-mcp"]}'

本地安装（可选）

git clone https://github.com/zhizhuodemao/js-reverse-mcp.git
cd js-reverse-mcp
npm install
npm run build

然后在 MCP 配置中使用本地路径：

{
  "mcpServers": {
    "js-reverse": {
      "command": "node",
      "args": ["/你的路径/js-reverse-mcp/build/src/index.js"]
    }
  }
}

反检测机制

本项目的反检测分层清晰。包装层（这个 MCP 自己）零 JS 注入、不做 Object.defineProperty hack（那本身就是检测信号）。所有反检测都在两个互不重叠的层：

层	默认模式	`--cloak` 模式
协议层（CDP）	Patchright：不调 `Runtime.enable` / `Console.enable`，在 isolated world 里执行 evaluate，移除自动化 launch flag	同
源码层（C++ 二进制 patch）	无 —— 直接用系统 Google Chrome	CloakBrowser 二进制（49 个 C++ patch：`navigator.webdriver`、canvas、WebGL、audio、GPU、字体、屏幕、WebRTC、TLS）
Profile 目录	`~/.cache/chrome-devtools-mcp/chrome-profile`（持久化登录态）	`~/.cache/chrome-devtools-mcp/cloak-profile`（与默认物理隔离）
实际浏览器	你装的 Google Chrome（带 Web Store、扩展、sync）	定制 Chromium 编译版（无 Google 服务、无 Web Store）

另外几个导航级措施（两种模式都生效）：

CDP 静默导航 —— 页面加载时不激活 Network.enable / Debugger.enable，请求/控制台收集只走 Playwright 监听器，直到某个工具显式需要 CDP 才激活
Google Referer —— new_page 默认带 referer: https://www.google.com/
真实视口 —— 关掉 Playwright 默认的 1280×720 假视口，浏览器展示真实屏幕尺寸

何时开 --cloak：只在以上还不够、被站点指纹拦截时才用。详见 docs/cloak.md。

工具列表（21 个）

页面与导航

工具	描述
`select_page`	列出打开的页面，或按索引选择调试上下文
`new_page`	创建新页面并导航到 URL
`navigate_page`	导航、后退、前进或刷新页面
`select_frame`	列出所有 frame（iframe），或选择执行上下文
`take_screenshot`	截取页面截图

脚本分析

工具	描述
`list_scripts`	列出页面中所有加载的 JavaScript 脚本
`get_script_source`	获取脚本源码片段，支持行范围或字符偏移
`save_script_source`	保存完整脚本源码到本地文件（适用于大型/压缩/WASM文件）
`search_in_sources`	在所有脚本中搜索字符串或正则表达式

断点与执行控制

工具	描述
`set_breakpoint_on_text`	通过搜索代码文本自动设置断点（适用于压缩代码）
`break_on_xhr`	按 URL 模式设置 XHR/Fetch 断点
`remove_breakpoint`	按 ID、URL 或全部移除断点，自动恢复执行
`list_breakpoints`	列出所有活动断点
`get_paused_info`	获取暂停状态、调用栈和作用域变量
`pause_or_resume`	切换暂停/恢复执行
`step`	单步调试（over/into/out），返回位置和源码上下文

网络与 WebSocket

工具	描述
`list_network_requests`	列出网络请求，或按 reqid 获取单条详情
`get_request_initiator`	获取网络请求的 JavaScript 调用栈
`get_websocket_messages`	列出 WebSocket 连接、分析消息模式或获取消息详情

检查工具

工具	描述
`evaluate_script`	在页面中执行 JavaScript（支持断点上下文、主世界执行和保存结果/二进制数据到文件）
`list_console_messages`	列出控制台消息，或按 msgid 获取单条详情

使用示例

JS 逆向基本流程

打开目标页面

打开 https://example.com 并加载