Js Reverse Mcp
by
Debug and analyze JavaScript code running in real Chrome pages, with persistent login state, zero script injection and layered anti‑detection, enabling AI coding assistants to perform genuine reverse‑engineering workflows.
Js Reverse Mcp Overview
What is Js Reverse Mcp about?
Js Reverse Mcp provides a JavaScript reverse‑engineering MCP server that lets AI agents (Claude, Cursor, Copilot, etc.) control a real Chrome instance, set breakpoints, inspect runtime values, analyze network traffic and WebSocket messages, all while mimicking a genuine user to bypass anti‑bot protections.
How to use Js Reverse Mcp?
- Quick start with npx – add the server to your AI‑assistant MCP configuration:
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
}
}
}
- Optional flags –
--cloakto enable the CloakBrowser binary for strong anti‑scraping sites,--isolatedfor a fresh profile each run, or--browserUrlto attach to an already‑running Chrome. - Local install (if preferred): clone the repo, run
npm install && npm run build, then point the MCP config to the builtindex.js.
Key features of Js Reverse Mcp
- Default headed debugging – visible Chrome window, breakpoints, step‑over/into/out, call‑stack view.
- Persistent login state – cookies and localStorage survive across sessions.
- Two‑layer anti‑detection:
- Protocol‑level: Patchright disables suspicious CDP commands.
- Source‑level (optional
--cloak): CloakBrowser applies 49 C++ fingerprint patches.
- Script analysis – list all loaded scripts, search, retrieve and save source code.
- Breakpoint management – text‑based, conditional, XHR/Fetch breakpoints, auto‑removal.
- Execution control – pause/resume, step debugging with source context.
- Runtime inspection – evaluate expressions, view scoped variables at pause points.
- Network & WebSocket inspection – request initiators, message patterns, detailed frames.
- Zero JS injection – no
Object.definePropertyhacks, keeping the page untouched.
Use cases of Js Reverse Mcp
- Security research – dissect obfuscated malicious scripts on target sites.
- Anti‑scraping bypass – interact with Cloudflare, DataDome or FingerprintJS protected pages while remaining undetected.
- AI‑assisted debugging – let Copilot or Claude automatically set breakpoints and extract runtime data.
- WebSocket protocol reverse‑engineering – capture and analyze real‑time message flows.
- Educational reverse‑engineering labs – provide students with a safe, real‑browser environment.
FAQ from the Js Reverse Mcp
Q: Do I need to install Chrome separately?
A: Yes, the server drives the Chrome version installed on your machine. For --cloak it will download a custom Chromium binary automatically.
Q: Will my cookies be leaked?
A: Cookies and localStorage are persisted only in the user’s local profile (~/.cache/chrome-devtools-mcp/chrome-profile). Use --isolated for a disposable profile.
Q: How does the anti‑detection work?
A: At the CDP level Patchright avoids enabling Runtime and Console domains that reveal automation. The optional CloakBrowser binary patches 49 fingerprintable APIs (navigator.webdriver, canvas, WebGL, audio, GPU, fonts, etc.).
Q: Can I attach to an already running Chrome?
A: Yes, provide the --browserUrl flag with the CDP HTTP endpoint (e.g., http://127.0.0.1:9222).
Q: How to debug a site that still blocks me after --cloak?
A: Try clearing the persisted profile (rm -rf ~/.cache/chrome-devtools-mcp/chrome-profile) or use the --isolated flag to start fresh.
Q: What AI assistants are supported? A: Any MCP‑compatible client – Claude, Cursor, VS Code Copilot, Codex, and custom tools.
Js Reverse Mcp's README
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 消息分析
系统要求
快速开始（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 并列出所有加载的 JS 脚本
- 查找目标函数
在所有脚本中搜索包含 "encrypt" 的代码
- 设置断点
在加密函数入口处设置断点
- 触发并分析
在页面上触发操作，断点命中后检查参数、调用栈和作用域变量
WebSocket 协议分析
列出 WebSocket 连接，分析消息模式，查看特定类型的消息内容
配置选项
CLI 刻意精简到 4 个 flag，全部可选。99% 场景默认即可。
| 选项 | 描述 | 默认值 |
|---|---|---|
--cloak |
切换到 CloakBrowser 隐身二进制（取代系统 Chrome）。叠加 49 个 C++ 源码层指纹 patch。首次启动自动下载 ~200MB 二进制；指纹身份按 profile 持久化。详见 docs/cloak.md。 | false |
--isolated |
使用临时 user-data-dir（cookies/localStorage 不保留，关闭时自动清理） | false |
--browserUrl, -u |
连接到已运行的 Chrome 实例（CDP HTTP 端点，如 http://127.0.0.1:9222）。MCP 会自动探测出 WebSocket debugger URL。本地 Chrome、AdsPower、BitBrowser 等怎么拿到这个端点详见 docs/cdp-endpoint.md。 |
– |
--logFile |
调试日志输出文件路径（配合 DEBUG=* 环境变量得到详细日志） |
– |
示例配置
默认 —— 系统 Chrome + 持久化登录态（绝大多数调试场景推荐）：
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
}
}
}
--cloak —— 强反爬站点（Cloudflare Turnstile / DataDome / FingerprintJS 防护）：
强烈推荐：先把二进制预下载好（一次性，~30–60 秒）。不做这一步的话，首次启动带
--cloak的 MCP 会静默下载 ~200MB，看起来像 MCP 卡住了：npx cloakbrowser install（
cloakbrowser包已经通过optionalDependencies一起装好，这条命令只是触发它自带的二进制下载逻辑，有进度条）
{
"mcpServers": {
"js-reverse-cloak": {
"command": "npx",
"args": ["js-reverse-mcp", "--cloak"]
}
}
}
两套并行 —— 两个 MCP 实例 profile 物理隔离，根据目标站点切换：
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp"]
},
"js-reverse-cloak": {
"command": "npx",
"args": ["js-reverse-mcp", "--cloak"]
}
}
}
--isolated —— 每次全新 profile（不保留 cookies/localStorage）：
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp", "--isolated"]
}
}
}
连接到已运行的 Chrome / 第三方指纹浏览器
--browserUrl 只接受 CDP endpoint（能响应 /json/version 的 HTTP 端点），不接受厂商私有 Local API。本地 Chrome、AdsPower、BitBrowser 等场景下怎么拿到 CDP 端口，详见专门的文档：
📖 docs/cdp-endpoint.md —— 如何拿到 CDP 调试端口
最短路径（本地 Chrome）：
# 先关掉所有 Chrome 窗口，然后
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
--remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug
{
"mcpServers": {
"js-reverse": {
"command": "npx",
"args": ["js-reverse-mcp", "--browserUrl", "http://127.0.0.1:9222"]
}
}
}
指纹浏览器（AdsPower、BitBrowser 等）的 CDP 端口是每次启动随机变化的，必须通过厂商 Local API 启动浏览器后再提取，操作步骤和示例脚本都在上面那篇文档里。
故障排除
被反爬系统拦截
如果访问某些站点被拦截（如知乎返回 40362、Cloudflare 挑战死循环）：
- 先试
--isolated—— 用全新 profile 排除残留状态污染："args": ["js-reverse-mcp", "--isolated"] - 还不行就开
--cloak—— 加 49 个源码层指纹 patch："args": ["js-reverse-mcp", "--cloak"] - 最后再考虑手动清持久化 profile（会丢登录态）：
rm -rf ~/.cache/chrome-devtools-mcp/chrome-profile
什么时候该开 --cloak、什么时候不该开，详见 docs/cloak.md。
安全提示
此工具会将浏览器内容暴露给 MCP 客户端，允许检查、调试和修改浏览器中的任何数据。请勿在包含敏感信息的页面上使用。
许可证
Apache-2.0
Js Reverse Mcp Reviews
Login Required
Please log in to share your review and rating for this MCP.
Similar MCP Servers like Js Reverse Mcp
Explore related MCPs that share similar capabilities and solve comparable challenges
Git
Officialby modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
Zed
OfficialClientby zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
Everything
Officialby modelcontextprotocol
Model Context Protocol Servers
Time
Officialby modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
Cline
OfficialClientby cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
Context7 MCP
Officialby upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
Daytona
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.
Continue
OfficialClientby continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
GitHub MCP Server
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.