JS Reverse MCP

JS Reverse MCP 是一款面向 AI Agent（如 Claude Code、Cursor、Copilot）的 Model Context Protocol (MCP) 服务器，旨在将复杂的浏览器调试与 JavaScript 逆向工程任务转化为 AI 可理解、可执行的结构化工具。它不仅仅是 Chrome DevTools API 的简单映射，而是重新组织了脚本分析、断点控制、网络监控及浏览器状态管理，使 AI 能够像专业分析师一样持续调试、定位、保存和复盘网页中的 JS 行为。

核心设计理念：AI-Native 而非 DevTools 映射

• 🤖 智能体原语 (Agent Primitives)：工具粒度围绕 AI 决策设计。例如，list_network_requests 既能列出索引，也能按 ID 查详情或导出原始材料；evaluate_script 支持在页面或断点上下文中执行，并能读取本地文件输入。
• 📂 本地文件作为工作台：避免将大段代码或二进制数据塞入聊天上下文。通过 save_script_source 和 outputFile 参数，AI 可以在浏览器、网络和本地文件之间高效往返，实现可复盘的工作流。
• 🔄 状态可清理与流程可重放：默认保留登录态以支持跨会话分析；提供 clear_site_data 仅清理当前站点状态，方便反复复现 Cookie 生成、风控初始化及请求链路。
• 🛡️ 反检测服务于调试：所有反检测手段（Patchright 协议层 Stealth、CloakBrowser 源码层指纹）的目标都是确保 AI 能顺利进入目标页面并维持分析链路，而非构建泛用爬虫。

关键功能模块

1. 🕸️ 脚本深度分析

• 源码获取与保存：列出所有加载的 JS，支持按行范围或字符偏移获取片段，并将大型/压缩/WASM 脚本完整保存到本地文件。
• 全局搜索：在所有脚本中搜索字符串或正则表达式，快速定位关键逻辑。
• 自动格式化：针对压缩代码提供友好的展示格式。

2. 🛑 断点与执行控制

• 智能断点设置：支持通过搜索代码文本自动设置断点（尤其适用于压缩代码），以及按 URL 模式设置 XHR/Fetch 断点。
• 暂停上下文检查：在断点暂停时，直接获取调用栈、作用域变量及源码上下文。
• 单步调试：支持 Step Over/Into/Out，并返回精确的位置与上下文信息。

3. 🌐 网络与 WebSocket 监控

• 全量请求捕获：列出网络请求，导出 Header、Body、Query 等原始材料，识别 Set-Cookie 行为。
• 调用栈追踪：获取网络请求的 JavaScript 发起者调用栈，追溯请求源头。
• WebSocket 分析：分组管理 WS 连接，分析消息模式并获取详情。

4. 🖥️ 浏览器状态管理

• 持久化与隔离：默认使用有头浏览器并保留 Cookies/LocalStorage；支持 --isolated 模式提供一次性干净环境。
• 精准清理：clear_site_data 仅清理当前站点相关数据，不影响其他会话，便于复现特定风控流程。

反检测机制：双层防护体系

注：两种模式均启用 CDP 静默导航、Google Referer 及真实视口尺寸。

快速开始

方式一：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
• 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

在配置中使用本地路径：node /你的路径/js-reverse-mcp/build/src/index.js

系统要求

• Node.js: v20.19 或更新版本
• 浏览器: Chrome 稳定版