JS Reverse MCP

English | 中文

AI 우선 / AI 네이티브 JavaScript 역공학 MCP Server로, AI 코딩 어시스턴트(Claude, Cursor, Copilot 등)가 분석가처럼 웹페이지의 JavaScript 동작을 지속적으로 디버깅하고, 위치를 파악하고, 저장하고, 재검토할 수 있게 해줍니다.

Chrome DevTools API를 그대로 모델에 전달하는 것이 아니라, 스크립트, 중단점, 네트워크, WebSocket, 브라우저 상태 및 로컬 파일 I/O를 AI Agent의 연속적인 추론과 조작에 적합한 도구로 재구성합니다. 안티 탐지도 그 능력의 일부입니다. 기본적으로 본 MCP를 위해 재컴파일되어 배포되고 독립적으로 유지 관리되는 Patchright fork를 사용하여 프로토콜 계층 stealth를 제공하며, 강한 안티 크롤링 사이트에서는 선택적으로 CloakBrowser 소스 코드 계층 핑거프린트 모드를 활성화할 수 있습니다.

☁️ 후원 · Sponsored by IPWO

IPWO 주거용 프록시는 유연한 프록시 구성을 지원하므로, 개발자는 작업에 따라 적합한 네트워크 환경을 선택하여 웹 접속, 요청 테스트, 지역화 콘텐츠 분석 및 자동화 워크플로우에 사용할 수 있습니다.

JS 역공학, 브라우저 디버깅, 웹 네트워크 분석과 관련된 프로젝트에서 주거용 프록시는 네트워크 환경의 보완 옵션으로도 활용할 수 있으며, 개발자가 다양한 지역의 접속 및 테스트 요구를 보다 유연하게 충족할 수 있도록 도와줍니다.

👉 무료 테스트 입구, 10% 할인 코드: 0204

Related MCP server: Chrome DevTools MCP

☁️ 후원 · Sponsored by Infistar.cc 무한성하

js-reverse-mcp × Infistar.cc 무한성하｜전 모델 API · 안정적으로 AI 보조 디버깅 구동

Infistar.cc 무한성하의 후원에 감사드리며, js-reverse-mcp에 모델 서비스 지원을 제공해 주셨습니다!

• ⚡ 복잡한 디버깅 작업을 안정적으로 처리: 기업급 고동시 채널과 다중 노드 이중화를 제공하며, 가격은 공식 채널의 10% 수준으로 낮아 rate limit, 429 및 장기 작업 연결 끊김 문제를 줄여줍니다.

• 🧠 하나의 API Key로 주요 모델 접근: ChatGPT, Claude, Gemini, Kimi, GLM, DeepSeek 등 모델을 지원하며, Claude Code, Codex, Cursor 등 AI 프로그래밍 도구에 적용됩니다.

• 🔎 권한 있는 디버깅 및 보안 연구 지원: 스크립트 검색, 중단점 분석, 네트워크 요청 추적, 호출 스택 점검, 코드 로직 이해 등 다단계 작업에 적합합니다.

• 📦 프로젝트 사용자 전용 혜택: 전용 추천 링크로 가입하고 첫 호출을 완료하면 5달러 상당의 테스트 크레딧 / 첫 충전 전용 할인을 받을 수 있습니다.

위치: Claude Code / Codex 모델 API 구성 지원.

기능 특징

• AI-native 도구 설계: 도구의 세분화, 출력 경계 및 오류 메시지가 모두 Agent의 의사 결정을 중심으로 설계되어, 모델을 무의미한 다음 단계로 유도하지 않습니다.

• 재검토 가능한 워크플로우: 스크립트 소스 코드, 네트워크 원본 데이터, 바이너리 결과를 로컬 파일로 내보낸 후 후속 분석 입력으로 사용할 수 있습니다.

• 중단점 컨텍스트 실행: 일시 중지 시 call frame에서 직접 평가, 스코프 변수 검사, 단계 실행 및 소스 코드 컨텍스트 반환이 가능합니다.

• 스크립트 분석: 로드된 모든 JS를 나열하고, 코드를 검색하고, 소스를 가져와 저장하며, 대형 압축 스크립트를 자동으로 포맷합니다.

• 네트워크 및 WebSocket 분석: 요청 호출 스택, XHR 중단점, Set-Cookie 식별, 원본 body/header 내보내기, WebSocket 메시지 그룹화.

• 브라우저 상태 재생: 현재 사이트의 cookies / cache / storage / sessionStorage를 정리하고, reload와 함께 cookie 및 리스크 컨트롤 프로세스를 재현합니다.

• 기본 헤드 풀 + 영구 로그인 상태: 브라우저가 보이고, cookies / localStorage가 세션 간 유지됩니다.

• 전용 Patchright 커널: 기본적으로 이 프로젝트에서 독립적으로 유지 관리하는 Patchright fork에 의존하며, 업스트림의 알려진 공유 구현 특징을 지속적으로 수정합니다.

• 선택적 안티 탐지 계층: 전용 Patchright 프로토콜 계층 stealth가 기본적으로 활성화됩니다. 강한 안티 크롤링 사이트에서는 --cloak을 추가하여 CloakBrowser 바이너리를 사용할 수 있습니다.

전용 Patchright fork

js-reverse-mcp는 더 이상 Patchright의 일반 배포 패키지에 직접 의존하지 않고, 본 MCP를 위해 특별히 컴파일되어 배포된 @zhizhuodemao/patchright를 사용합니다. 이 fork는 독립 저장소에서 지속적으로 유지 관리되며, 본 MCP의 실제 탐지 샘플과 함께 발전합니다.

• 더 이상 Patchright 일반 배포 패키지에 직접 의존하지 않음

• 확인된 업스트림 공유 구현 특징에 대해 프로토콜 계층 조정을 수행하고 재컴파일하여 배포

• 안티 탐지 조정은 페이지 수준 JS 주입에 의존하지 않음

• evaluate, locator 및 페이지 제어 등 원래 기능 유지

• fork는 본 MCP를 위한 전용 저장소에서 지속적으로 유지 관리됨

공개 문서는 설계 경계만 설명하며 내부 탐지 샘플과 구현 세부 사항은 다루지 않습니다. 전용 fork의 목표는 확인된 공유 구현 특징을 줄이는 것이지, 브라우저 자동화가 절대적으로 탐지 불가능함을 약속하는 것이 아닙니다.

시스템 요구 사항

• 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

사용 가능한 모델 API가 없거나 사용자 정의 API 주소를 구성해야 하는 경우: Claude Code / Codex 타사 모델 API 구성 튜토리얼을 참조하세요.

Codex

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

사용 가능한 모델 API가 없거나 사용자 정의 API 주소를 구성해야 하는 경우: Claude Code / Codex 타사 모델 API 구성 튜토리얼을 참조하세요.

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"]
    }
  }
}

AI-first 설계

이 프로젝트의 핵심 목표는 "브라우저를 조작할 수 있는 것"이 아니라, AI Agent가 실제 JS 역공학 작업의 한 라운드를 안정적으로 완료하는 것입니다: 페이지 열기, 리스크 컨트롤 통과, 스크립트 위치 파악, 소스 코드 저장, 중단점 설정, 동작 트리거, 런타임 검사, 네트워크 자료 내보내기, 상태 재현, 그리고 계속 추론하기.

코드 전체에 걸쳐 몇 가지 설계 방향이 적용되어 있습니다:

• 도구는 Agent primitives이지 DevTools 메뉴 매핑이 아닙니다: list_network_requests는 인덱스를 나열할 수도 있고, reqid로 상세 정보를 조회할 수도 있으며, outputFile로 정확한 자료를 내보낼 수도 있습니다. evaluate_script는 페이지에서 실행할 수도 있고, 중단점 call frame에서 실행할 수도 있으며, localFilePath 입력도 받을 수 있습니다.

• 출력은 다음 단계를 안내할 수 있어야 합니다: 목록 출력은 짧고 스캔하기 쉽게 유지됩니다. 상세 출력에는 경계가 있습니다. 긴 결과는 내보내기를 안내합니다. pending 요청은 Agent가 완료되지 않을 response를 기다리지 않도록 명시적으로 실행 재개를 먼저 안내합니다.

• 로컬 파일은 분석 워크벤치입니다: save_script_source, list_network_requests(..., outputFile), evaluate_script(..., localFilePath)를 통해 Agent가 브라우저, 네트워크, 로컬 파일 사이를 오갈 수 있게 하며, 긴 코드나 바이너리 데이터를 채팅 컨텍스트에 채워 넣지 않습니다.

• 상태는 정리 가능하고, 프로세스는 재생 가능합니다: 기본 profile은 로그인 상태를 유지합니다. --isolated는 일회성 깨끗한 환경을 제공합니다. clear_site_data는 현재 사이트 관련 상태만 지우며, cookie 생성, 리스크 컨트롤 초기화, 요청 체인을 반복적으로 재현하는 데 사용됩니다.

• 안티 탐지는 디버깅 체인에 서비스합니다: CDP 자동 탐지, 실제 뷰포트, Google referer, 전용 Patchright fork 및 CloakBrowser의 목표는 모두 Agent가 대상 페이지에 진입하여 분석을 계속할 수 있게 하는 것이지, 프로젝트를 범용 크롤러 프레임워크로 만드는 것이 아닙니다.

안티 탐지 메커니즘 (지원 능력)

안티 탐지는 js-reverse-mcp의 하위 지원 능력 중 하나입니다. 래핑 계층(이 MCP 자체)은 JS 주입이 전혀 없고, Object.defineProperty hack을 하지 않습니다(그 자체가 탐지 신호입니다). 모든 안티 탐지는 서로 겹치지 않는 두 계층에서 수행됩니다:

추가로 몇 가지 내비게이션 수준 조치(두 모드 모두 적용):

• CDP 자동 내비게이션 — 페이지 로드 시 Network.enable / Debugger.enable을 활성화하지 않고, 요청/콘솔 수집은 Playwright 리스너만 통과하며, 특정 도구가 명시적으로 CDP가 필요할 때만 활성화됩니다.

• Google Referer — new_page 기본값에 referer: https://www.google.com/ 포함.

• 실제 뷰포트 — Playwright의 기본 1280×720 가짜 뷰포트를 끄고, 브라우저가 실제 화면 크기를 표시합니다.

--cloak을 언제 켜야 하나요: 위 조치로도 부족하고 사이트 핑거프린트에 차단될 때만 사용합니다. 자세한 내용은 docs/cloak.md를 참조하세요.

도구 목록 (24개)

페이지 및 내비게이션

스크립트 분석

중단점 및 실행 제어

네트워크 및 WebSocket

브라우저 상태

검사 도구

사용 예시

JS 역공학 기본 흐름

1. 대상 페이지 열기

打开 https://example.com 并列出所有加载的 JS 脚本

2. 대상 함수 찾기

在所有脚本中搜索包含 "encrypt" 的代码

3. 중단점 설정

在加密函数入口处设置断点

4. 트리거 및 분석

在页面上触发操作，断点命中后检查参数、调用栈和作用域变量

WebSocket 프로토콜 분석

列出 WebSocket 连接，分析消息模式，查看特定类型的消息内容

Agent 권장 전체 캡처 흐름

내비게이션 단계에서 의도적으로 CDP를 조용히 유지하므로, 대상 페이지에 처음 진입할 때 Network / Debugger 도메인이 즉시 열리지 않습니다. 권장 흐름은 먼저 리스크 컨트롤을 통과한 다음 새로고침하여 캡처하는 것입니다:

1. new_page 打开目标页
2. 调用 list_network_requests 激活 collectors
3. navigate_page(type="reload") 刷新页面
4. 再次 list_network_requests 查看完整请求
5. 对关键 reqid 使用 outputFile 导出原始材料

Cookie / 리스크 컨트롤 재생 흐름

1. clear_site_data(confirm=true) 清理当前站点状态
2. navigate_page(type="reload") 重新触发初始化
3. list_network_requests 找到设置 cookie 或提交 sensor 的请求
4. 导出 requestBody / responseHeaders / responseBody
5. 用 evaluate_script + localFilePath 在页面上下文中复算或验证

구성 옵션

CLI는 간결하게 유지되며 모든 flag는 선택 사항입니다. 99% 시나리오에서 기본값으로 충분합니다. 로컬 파일과 관련된 경우 --allowedRoots를 사용하여 Agent가 읽고 쓸 수 있는 디렉터리를 제한하는 것이 좋습니다.

예시 구성

기본 — 시스템 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로 브라우저를 시작한 후 추출해야 합니다. 작업 절차와 예시 스크립트는 위 문서에 있습니다.

문제 해결

안티 크롤링 시스템에 차단됨

일부 사이트에 접속할 때 차단되면 (예: Zhihu 40362, Cloudflare 챌린지 무한 루프):

1. 먼저 --isolated 시도 — 새 profile로 잔여 상태 오염 제외:

   "args": ["js-reverse-mcp", "--isolated"]

2. 그래도 안 되면 --cloak 활성화 — 플랫폼별 소스 코드 계층 핑거프린트 patch 활성화:

   "args": ["js-reverse-mcp", "--cloak"]

3. 마지막으로 영구 profile 수동 정리 고려 (로그인 상태가 사라짐):

   rm -rf ~/.cache/chrome-devtools-mcp/chrome-profile

--cloak을 언제 켜야 하고 언제 켜지 말아야 하는지는 docs/cloak.md를 참조하세요.

Agent 라우팅 평가 (유지 관리자)

npm run eval:routing:validate는 실제 MCP tools/list, server instructions과 evals/tool-routing.json의 30개 도구 선택 계약을 오프라인으로 검증합니다. 이 명령은 모델 엔드포인트에 접근하지 않으며 presubmit에 포함되어 있습니다.

실제 모델 평가는 명시적 opt-in이며, OpenAI-compatible Chat Completions 엔드포인트를 하나씩 호출하고 비용이 발생할 수 있습니다:

MCP_ROUTING_EVAL_ENDPOINT=https://api.example.com/v1/chat/completions \
MCP_ROUTING_EVAL_MODEL=model-name \
MCP_ROUTING_EVAL_API_KEY=secret \
npm run eval:routing

MCP_ROUTING_EVAL_API_KEY는 인증이 필요 없는 로컬 엔드포인트에서는 생략할 수 있습니다. 자격 증명이 있는 원격 엔드포인트는 HTTPS를 사용해야 하며, HTTP는 loopback만 허용됩니다. MCP_ROUTING_EVAL_TIMEOUT_MS로 단일 요청 타임아웃을 조정할 수 있습니다. 기본적으로 100% 통과를 요구하며, 모델 간 비교 시 MCP_ROUTING_EVAL_MIN_PASS_RATE로 (0, 1] 임계값을 설정할 수 있습니다. 평가는 API key, 엔드포인트 또는 엔드포인트 오류 응답 본문을 출력하지 않습니다.

보안 알림

이 도구는 브라우저 콘텐츠를 MCP 클라이언트에 노출하며, 브라우저의 모든 데이터를 검사, 디버깅 및 수정할 수 있도록 허용합니다. 민감한 정보가 포함된 페이지에서는 사용하지 마세요.

evaluate_script.localFilePath, 각종 outputFile/filePath는 MCP 프로세스가 호스트 머신의 파일을 읽거나 쓰게 합니다. 프로덕션 또는 공유 환경에서는 하나 이상의 --allowedRoots를 사용하여 전용 작업 디렉터리로 범위를 좁혀야 합니다. 미구성 시 접근 범위는 제한되지 않습니다. --allowedRoots를 활성화하면 file:, view-source:file:, filesystem:file: 브라우저 페이지도 거부되어 브라우저 탐색을 통한 디렉터리 경계 우회를 방지합니다. 로컬 페이지를 디버깅해야 하는 경우, 로컬 파일 노출 위험을 명시적으로 수용하는 세션에서만 해당 옵션을 구성하지 않아야 합니다.

라이선스

Apache-2.0