js-reverse-mcp

环境要求

• Node.js 环境（需能执行 npx 命令）
• 可用的 MCP 客户端（如 Claude Code、Cursor、Copilot 等）
• 默认场景需已安装系统 Chrome 浏览器
• 可选：使用 --cloak 时需 ~200MB CloakBrowser 二进制（可预下载）

安装与启动步骤

1. 1添加 npx 配置

   在 MCP 客户端的配置文件里新增 js-reverse 服务器，无需本地安装，npx 会自动获取并运行该包。

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

   复制

2. 2本地克隆构建

   可选的本地安装方式：克隆仓库后安装依赖并编译，产出 build 目录下的入口文件。

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

   复制

3. 3使用本地路径

   本地构建完成后，把 MCP 配置的 command 改为 node，args 指向 build/src/index.js 的绝对路径。

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

   复制

4. 4预下载隐身二进制

   计划使用 --cloak 时强烈建议先执行此命令，一次性下载约 200MB，耗时约 30~60 秒。

   npx cloakbrowser install

   复制

5. 5启用隐身模式

   面向 Cloudflare Turnstile、DataDome、FingerprintJS 等强反爬站点时，在 args 中追加 --cloak。

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

   复制

6. 6连接已有浏览器

   复用已运行的 Chrome 或第三方指纹浏览器时，用 --browserUrl 传入可响应 /json/version 的 CDP 端点。

   npx js-reverse-mcp --browserUrl http://127.0.0.1:9222

   复制

7. 7隔离与目录限制

   需要每次全新 profile 或限制 Agent 可读写目录时，追加 --isolated 与 --allowedRoots 参数。

   npx js-reverse-mcp --isolated --allowedRoots /your/path

   复制

关键配置

如何确认成功

在 MCP 客户端中确认 js-reverse 服务器已连接并列出其工具，即表示配置生效。

常见问题

注意事项

• 详细日志请用 DEBUG=mcp:*，不要用 DEBUG=*，浏览器协议日志可能泄露页面、Cookie、脚本和凭据。
• 未指定 --allowedRoots 时本地文件访问不受目录限制，启动时会打印安全警告；启用后会禁用 file:、view-source:file: 和 filesystem:file: 浏览器页面。
• --cloak 首次启动会自动下载约 200MB 二进制，指纹身份按 profile 持久化。
• 两套 MCP 实例（默认与 --cloak）profile 物理隔离，可按目标站点切换使用。