Skip to main content
Glama

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: MCP JS Debugger

☁️ 후원 · 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의 목표는 확인된 공유 구현 특징을 줄이는 것이지, 브라우저 자동화가 절대적으로 탐지 불가능함을 약속하는 것이 아닙니다.

시스템 요구 사항

빠른 시작 (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을 하지 않습니다(그 자체가 탐지 신호입니다). 모든 안티 탐지는 서로 겹치지 않는 두 계층에서 수행됩니다:

계층

기본 모드

--cloak 모드

프로토콜 계층 (CDP)

전용 Patchright fork: Runtime.enable / Console.enable를 호출하지 않고, isolated world에서 evaluate를 실행하며, 자동화 launch flag를 제거하고 알려진 공유 구현 특징을 지속적으로 수정합니다.

동일

소스 코드 계층 (C++ 바이너리 patch)

없음 — 시스템 Google Chrome을 직접 사용

CloakBrowser 바이너리 (플랫폼별 소스 코드 계층 핑거프린트 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를 참조하세요.

도구 목록 (24개)

페이지 및 내비게이션

도구

설명

select_page

열린 페이지를 나열하거나 인덱스로 디버깅 컨텍스트를 선택

new_page

새 페이지를 만들고 URL로 내비게이트

navigate_page

내비게이트, 뒤로, 앞으로 또는 페이지 새로고침

select_frame

모든 frame (iframe)을 나열하거나 실행 컨텍스트를 선택

click_element

현재 frame에서 단일 가시 요소를 엄격하게 매칭하여 클릭

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

명시적 action으로 ID, URL 또는 전체 중단점 제거

list_breakpoints

모든 활성 중단점 나열

get_paused_info

일시 중지 상태, 호출 스택 및 스코프 변수 가져오기

pause_or_resume

명시적 action으로 일시 중지 또는 실행 재개

step

단계 실행 (over/into/out), 위치 및 소스 코드 컨텍스트 반환

네트워크 및 WebSocket

도구

설명

list_network_requests

네트워크 요청 나열, 상세 정보 보기, 또는 header/body/query 등 원본 자료 내보내기

clear_network_requests

명시적 확인 후 현재 페이지에서 수집된 요청 및 body cache 정리

get_request_initiator

네트워크 요청의 JavaScript 호출 스택 가져오기

get_websocket_messages

WebSocket 연결 나열, 메시지 패턴 분석 또는 메시지 상세 정보 가져오기

브라우저 상태

도구

설명

clear_site_data

현재 사이트 관련 cookies, origin storage 및 sessionStorage 정리; 전역 HTTP cache는 명시적으로 선택하여 정리 가능

검사 도구

도구

설명

evaluate_script

페이지 또는 중단점 컨텍스트에서 JavaScript 실행, 메인 월드, 결과 저장 및 로컬 입력 파일 하나 읽기 지원

list_console_messages

콘솔 메시지 나열 또는 msgid로 단일 상세 정보 가져오기

사용 예시

JS 역공학 기본 흐름

  1. 대상 페이지 열기

打开 https://example.com 并列出所有加载的 JS 脚本
  1. 대상 함수 찾기

在所有脚本中搜索包含 "encrypt" 的代码
  1. 중단점 설정

在加密函数入口处设置断点
  1. 트리거 및 분석

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

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 导出原始材料
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가 읽고 쓸 수 있는 디렉터리를 제한하는 것이 좋습니다.

옵션

설명

기본값

--cloak

CloakBrowser 시크릿 바이너리로 전환 (시스템 Chrome 대체). 플랫폼별 C++ 소스 코드 계층 핑거프린트 patch 활성화. 첫 시작 시 ~200MB 바이너리를 자동으로 다운로드. 핑거프린트 ID는 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

0600 일반 파일로 MCP 디버그 로그 기록. 상세 로그는 DEBUG=mcp:*만 사용. DEBUG=*는 사용하지 마세요. 브라우저 프로토콜 로그에 페이지, Cookie, 스크립트 및 자격 증명이 노출될 수 있습니다.

–

--allowedRoots

Agent가 읽고 쓸 수 있는 로컬 디렉터리를 반복 지정. 실제 경로를 해석하고 심볼릭 링크의 경계 이탈을 거부. 활성화 시 file:, view-source:file:, filesystem:file: 브라우저 페이지가 비활성화됩니다. 미지정 시 로컬 파일 접근은 디렉터리 제한이 없으며, 시작 시 보안 경고가 출력됩니다.

–

예시 구성

기본 — 시스템 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

Available Tools

24 tools
break_on_xhrA

Sets a URL-substring breakpoint for a future XHR/Fetch when runtime request arguments, local variables, or payload construction must be inspected. For an already captured request, call get_request_initiator first because it is non-pausing; use this only when that evidence is insufficient. Set it before reproducing the user action—it does not inspect past traffic—then call get_paused_info/evaluate_script and finally step or resume. The URL pattern identifies this breakpoint for list_breakpoints and remove_breakpoint(action="remove_xhr").

Inputs: url (required). Returns: ok, data, tool, error, +1 more

clear_network_requestsA
DestructiveIdempotent

Discard captured HTTP(S) evidence for the currently selected page after confirm=true. Use this immediately before reproducing an action when a clean network capture window is needed; do not use it to reset login, cookies, cache, or other browser state. It irreversibly clears the in-memory request queue, cached response bodies, and initiator maps only. Browser cookies, HTTP cache, origin storage, console messages, and WebSocket connections/messages are unchanged; use clear_site_data for cookie and storage reset. New captures continue above the previous reqid high-water mark because reqids are never reused.

Inputs: confirm. Returns: ok, data, tool, error, +1 more

clear_site_dataA
DestructiveIdempotent

Irreversibly clear browser state after confirm=true to create a clean replay environment for the selected page. Use this before replaying login, session creation, storage initialization, or other state-dependent flows; do not use it to inspect cookies or determine which response set one. For cookie provenance, including HttpOnly, Secure, and SameSite attributes, use list_network_requests with cookieName first. Cleanup covers cookies affecting the selected page's HTTP(S) frames—including HttpOnly and Secure cookies through the browser context—persistent storage for those frame origins, and each HTTP(S) frame's sessionStorage. It does not reload the page. The browser HTTP cache is global and is preserved by default; set clearBrowserCache=true only when that wider cross-page effect is explicitly intended.

Inputs: confirm, clearBrowserCache. Returns: ok, data, tool, error, +1 more

click_elementA
Destructive

Performs one verified, auditable click in the currently selected frame. Use it when the task requires activating a known button, link, or control after selecting the correct page/frame and identifying a CSS selector; it is the preferred minimal interaction primitive over arbitrary evaluate_script code. It does not discover elements, type text, or silently guess among matches: the selector must resolve to exactly one element unless index is explicit, and the chosen element must be visible. A click can submit data, navigate, or trigger external effects, so confirm=true is required and the result reports the exact resolved element.

Inputs: selector (required), index, button, confirm, +2 more. Returns: ok, data, tool, error, +1 more

evaluate_scriptA
Destructive

Evaluates one focused JavaScript function for DOM/page state, web storage, page-defined globals, a paused-frame expression, or browser-side processing of one local file. Use it when those runtime values are the goal and no narrower evidence tool applies. Do not use document.cookie or page evaluation to investigate HttpOnly/Secure cookies, Set-Cookie provenance, or captured HTTP evidence; use list_network_requests with cookieName/reqid, and use search_in_sources/get_script_source for source discovery. While running, evaluation uses the selected frame's isolated world by default or its page main world with mainWorld=true; while paused, it always uses the chosen call frame and ignores mainWorld. Call get_paused_info before paused evaluation, then step or resume when finished. Arbitrary code can change page/external state and requires confirm=true; inline results are bounded, so use outputFile for exact large or binary results.

Inputs: function (required), confirm, mainWorld, frameIndex, +3 more. Returns: ok, data, tool, error, +1 more

get_paused_infoA
Read-only

Inspects the current call stack, source locations, and selected call-frame scopes after a code/XHR breakpoint or explicit pause has stopped execution. It neither creates a pause nor resumes one. Returned frameIndex values and callFrameIds belong only to the current pause and expire after any step or resume; use evaluate_script with frameIndex for a focused expression, then step or pause_or_resume(action="resume").

Inputs: frameIndex, includeScopes, maxScopeDepth. Returns: ok, data, tool, error, +1 more

get_request_initiatorA
Read-only

Non-pausing first action for tracing which JavaScript initiated a retained HTTP request when CDP initiator evidence was active. Pass the reqid from list_network_requests; because initiator capture starts lazily and is not retroactive, an older request may have no stack—in that case reproduce the action and inspect the new reqid, or set break_on_xhr before reproduction when runtime values are required. If the captured stack identifies the code, inspect its URL/location with get_script_source. If arguments, locals, or a dynamically built payload are still needed, use break_on_xhr, reproduce, then call get_paused_info or evaluate_script before stepping or resuming. This tool only reads retained evidence and does not pause or reproduce the request.

Inputs: requestId (required). Returns: ok, data, tool, error, +1 more

get_script_sourceA
Read-only

Reads a small source region around a search match, paused location, or known statement without executing or pausing the page. Select by URL when available because URL-backed scripts can be resolved again after navigation; use the debugger-context-scoped scriptId only for current inline/eval scripts. Use line ranges for normal source and offset/length for minified single-line bundles. For a whole, minified, or WASM source, use save_script_source; to observe runtime values next, call set_breakpoint_on_text against the original loaded source.

Inputs: url, length, offset, endLine, +2 more. Returns: ok, data, tool, error, +1 more

get_websocket_messagesA
Read-only

Inspect captured bidirectional WebSocket connections and frame payloads for the selected page. Use this for WebSocket, socket, live-update, push, streaming, or realtime message flows; use list_network_requests for ordinary HTTP/XHR/fetch traffic and WebSocket upgrade request headers. WebSocket capture starts lazily on this tool's first use and is not retroactive: if the relevant socket already connected or exchanged frames, call this tool once to initialize capture, then reload or reproduce the flow. Without wsid it lists connections so you can choose one. With wsid it lists paginated sent/received frames; add show_content=true for payload previews. With wsid and analyze=true it groups frames by payload pattern and returns group IDs and sample frame indices; then use groupId to inspect one pattern. With wsid and frameIndex it returns one retained frame's detailed payload using the stable index shown in frame tables or analysis samples.

Inputs: wsid, analyze, groupId, pageIdx, +6 more. Returns: ok, data, tool, error, +1 more

list_breakpointsA
Read-only

Inspects code and XHR/Fetch breakpoints managed by this MCP session before reproducing an action or cleaning up debugger state. Returns current code breakpointIds and the exact XHR URL patterns needed by remove_breakpoint; URL-backed definitions are restored after navigation when possible, but a rebuilt debugger session may assign new IDs. This does not show why or where execution is currently paused—use get_paused_info for the active call stack.

Inputs: pageIdx, pageSize. Returns: ok, data, tool, error, +1 more

list_console_messagesA
Read-only

Inspects console messages and uncaught page errors captured for the selected page. Use it to diagnose runtime failures, warnings, application logs, or values already emitted by page code; use search_in_sources for source text and list_network_requests for HTTP evidence instead. Without msgid it lists messages 20 per page by default, optionally filtered by type or retained navigation history. With msgid it returns one message by its stable ID for focused inspection. Capture begins when this MCP attaches and is not retroactive, so reload or reproduce code that logged before attachment.

Inputs: msgid, types, pageIdx, pageSize, +1 more. Returns: ok, data, tool, error, +1 more

list_network_requestsA

Inspect captured HTTP(S) traffic for the currently selected page. Use this for API calls, request or response headers and bodies, redirects, authentication/session flows, replay or signing inputs, and determining which response created, refreshed, rotated, overwritten, or deleted a cookie. Without reqid it lists and filters requests; with cookieName it traces exact response Set-Cookie updates oldest-first, including cookies with HttpOnly, Secure, or SameSite attributes that page JavaScript cannot fully inspect; with reqid it returns bounded request details; with reqid plus outputFile it exports exact data. To inspect complete Set-Cookie values and attributes, export outputPart="responseHeaders" for a reqid returned by cookieName mode. cookieName never searches outbound Cookie request headers. Use get_websocket_messages for WebSocket frame payloads; this tool only represents the HTTP upgrade request. Capture begins when this MCP attaches and is not retroactive, so reload or reproduce traffic that occurred earlier. Captures then survive navigation in a 5000-request FIFO queue. List and cookie-flow modes default to 20 items per page; filters combine with AND and multiple values inside one filter combine with OR.

Inputs: reqid, methods, pageIdx, pageSize, +6 more. Returns: ok, data, tool, error, +1 more

list_scriptsA
Read-only

Discovers JavaScript currently loaded in the selected debugger context—the main frame by default, or the frame chosen with select_frame. Use select_frame first for iframe-specific source/debugger work. Includes external, inline, and eval scripts in that context; if you already know a function name, endpoint, or code literal, use search_in_sources instead. Each result includes a context-scoped scriptId that expires on reload, navigation, or debugger target change and, for external scripts, a URL that is the preferred selector for get_script_source or save_script_source.

Inputs: filter, pageIdx, pageSize. Returns: ok, data, tool, error, +1 more

new_pageA

Opens a separate browser page for a URL, reusing an existing about:blank startup tab when available. Use this when the task needs another tab or should preserve the currently selected page; use navigate_page to change the URL in the existing selected page instead. It waits for DOMContentLoaded, not every background resource, and then makes the opened page the target for later tools. It preserves cookies, storage, cache, and other browser state; use clear_site_data separately when a clean replay is required.

Inputs: url (required), timeout. Returns: ok, data, tool, error, +1 more

pause_or_resumeA

Explicitly requests an immediate pause or resumes an existing paused execution; it never toggles implicitly. Use a code breakpoint or break_on_xhr instead when a specific statement/request should stop, and use get_paused_info before resuming if evidence must be collected. Resuming invalidates current callFrameIds and frame indices.

Inputs: action (required). Returns: ok, data, tool, error, +1 more

remove_breakpointA
DestructiveIdempotent

Removes a known code breakpoint, XHR/Fetch breakpoint, or every MCP-managed breakpoint after explicit confirmation. Use breakpointId from set_breakpoint_on_text/list_breakpoints for remove_code, or reuse the exact URL pattern from break_on_xhr/list_breakpoints for remove_xhr. Removal does not resume an already paused page; call pause_or_resume(action="resume") separately after inspection.

Inputs: action (required), url, confirm, breakpointId. Returns: ok, data, tool, error, +1 more

save_script_sourceA

Saves one complete JavaScript or WASM source for local inspection when an inline snippet is insufficient, especially for large or minified bundles. Prefer get_script_source for a small known region and search_in_sources to locate text across loaded scripts first. With format=true, destinations using a supported JavaScript/TypeScript extension are formatted by default; other extensions preserve raw source, and formatted line numbers may differ from the live page. Use distinctive text plus the original URL with set_breakpoint_on_text for runtime debugging. The returned filename is the resolved local path, while scriptId remains scoped to the current debugger context.

Inputs: filePath (required), url, format, scriptId, +1 more. Returns: ok, data, tool, error, +1 more

search_in_sourcesA
Read-only

Finds a known function name, endpoint, string literal, token, or code pattern in JavaScript loaded by the selected debugger context—the main frame by default, or the frame chosen with select_frame. It searches external, inline/eval, and minified sources in that context without executing or pausing the page, returning 1-based lines plus context-scoped scriptIds; URLs are the preferred selectors for URL-backed matches. Use select_frame first for iframe-specific source work, get_script_source for nearby context, save_script_source for a whole bundle, or set_breakpoint_on_text when runtime values are needed. For a known captured request, prefer get_request_initiator before a broad source search.

Inputs: query (required), isRegex, urlFilter, maxResults, +3 more. Returns: ok, data, tool, error, +1 more

select_frameA

Lists or selects frames, including iframes, within the current page. Use it when the target element, page-defined global, script, or execution context may live in an iframe: first list frames, then pass frameIdx before click_element or evaluate_script. Omitting frameIdx lists 20 frames per page without changing context; passing frameIdx changes the shared frame target, with 0 restoring the main frame. It does not switch browser tabs or navigate—use select_page or navigate_page for those actions—and listPageIdx only paginates this listing.

Inputs: frameIdx, pageSize, listPageIdx. Returns: ok, data, tool, error, +1 more

select_pageA

Lists or selects open browser pages. Use it without pageIdx to identify the active page or choose the correct tab before inspecting network traffic, scripts, frames, or console output; pass pageIdx to make one listed page the shared target for later tools. It does not navigate or create pages: use navigate_page to change the selected page's URL and new_page when a separate tab is required. listPageIdx only paginates the page listing and never changes selection.

Inputs: pageIdx, pageSize, listPageIdx. Returns: ok, data, tool, error, +1 more

set_breakpoint_on_textA

Sets a restorable URL-backed breakpoint when distinctive code text is known and its runtime values must be observed. Call it directly when the user already supplies precise text plus any URL/occurrence disambiguation; use search_in_sources/get_script_source first only when the location is unknown or ambiguous. For an API with no known code location, start with list_network_requests and get_request_initiator or use break_on_xhr. On a hit, call get_paused_info, optionally evaluate_script, then step or resume. Returns the current breakpointId for remove_breakpoint; list breakpoints again after a rebuilt debugger session, and note that unnamed inline/eval scripts cannot use this URL breakpoint.

Inputs: text (required), condition, urlFilter, occurrence. Returns: ok, data, tool, error, +1 more

stepA

Advances JavaScript execution by one debugger operation from an existing pause and returns the next stopped call frame with concise source context. Use after get_paused_info or evaluate_script when control flow still needs tracing; it cannot start from running execution. Each advance invalidates prior callFrameIds, so inspect the new pause again as needed, then use pause_or_resume(action="resume") to finish.

Inputs: direction (required). Returns: ok, data, tool, error, +1 more

take_screenshotA

Captures the visual state of the currently selected page. Use it to verify page layout, visible UI state, selector targets, in-page dialogs/modals, or the effect of a navigation/click; it is not a substitute for DOM values, network evidence, or script inspection. By default it returns the visible viewport, while fullPage=true captures the whole document; oversized captures may be saved as a temporary artifact instead of attached. Pass filePath for a reusable local artifact; existing files require confirmOverwrite=true and remain subject to --allowedRoots.

Inputs: format, quality, filePath, fullPage, +1 more. Returns: ok, data, tool, error, +1 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 24 tools

    Disambiguation3/5

    Tools are organized around specific debugging actions, but many overlap in purpose (e.g., multiple breakpoint and pause/resume tools, multiple request inspection tools). While descriptions are precise, an agent could easily confuse which tool to use for a given step, especially with 24 tools.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern in snake_case (e.g., clear_network_requests, click_element). A few deviate slightly (e.g., 'break_on_xhr', 'get_paused_info'), but overall the naming is predictable and readable.

    Tool Count3/5

    24 tools is on the higher side for a focused reverse engineering server. The set is comprehensive but some tools could be merged (e.g., clear_network_requests and clear_site_data are distinct but very similar). Still, each tool has a clear role, so the count is borderline but acceptable.

    Completeness4/5

    The tool surface covers all major aspects of JavaScript reverse engineering: network interception, source inspection, breakpoint management, page control, and evaluation. Minor gaps exist (e.g., no direct DOM query tool), but the set is largely complete for its purpose.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to debug frontend applications by providing direct access to browser DevTools, React state, DOM inspection, and runtime debugging capabilities. Bridges the gap between AI and complex web applications for autonomous debugging and issue resolution.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to debug JavaScript and TypeScript applications by connecting to Chrome DevTools Protocol-compatible debuggers, allowing them to set breakpoints, step through code, inspect variables, and evaluate expressions with full source map support.
      18
      2
      Apache 2.0