jshook의 차별점

JS 분석을 위한 대부분의 MCP 서버는 소수의 직접 만든 도구를 노출하거나 단일 브라우저 엔진을 감쌀 뿐입니다. jshook은 프런트엔드 리버스 엔지니어링을 위한 운영체제에 더 가깝습니다 — 36개의 자동 발견 도메인, 토큰 비용을 통제하는 검색 우선 메타 도구, 그리고 깨진 페이지와 끊긴 세션에서도 살아남는 런타임 복구 기능을 갖추고 있습니다:

• 검색 우선, 프로필 인지형. search 프로필은 약 3K 토큰의 도구 메타데이터를 로드하고, full 프로필은 735개 도구 전체를 약 109K 토큰으로 노출합니다 (2026-10-10 측정 — 이 수치는 도구 개수에 따라 확장되므로 카탈로그가 커지면 다시 측정하세요). 에이전트는 작업이 커짐에 따라 search → workflow → full로 이동하며, 첫 턴부터 스키마에 익사하지 않습니다.
• 런타임 복구와 세션 격리. Streamable HTTP 세션은 재연결 후 활성화된 도메인, 브라우저 연결 상태, 커버리지 상태를 복원합니다. 클라이언트별 브라우저 측 상태는 격리되어 두 에이전트가 서로의 CDP 세션을 덮어쓸 수 없습니다.
• 풀스택 브라우저 자동화. CDP를 통한 Chromium 및 Camoufox(안티 디텍션 포함), 명시적 입력 CAPTCHA 솔버(내장 페이지/기능 프로빙 없음), 필요 시 자체 서명 HTTPS 인터셉션 CA, HTTP/2 프레임 빌딩.
• 문자열 검색이 아닌 진짜 리버스 엔지니어링. wabt를 통한 WASM 디스어셈블리(wasm2wat / wasm-decompile / wasm-objdump), Frida/Ghidra/IDA 브리지, 네이티브 FFI 스캐닝, 하드웨어 브레이크포인트, PE 인트로스펙션, GraphQL/Burp Suite 프록시 브리지, AST 변환 — 도구로 감싼 단일 정규식 호출이 아닙니다.
• 동적 확장성. 핫 리로드 플러그인, 선언적 워크플로, 자동 발견을 통해 재배포 없이 서버가 계속 성장합니다.

---

기능 개요

무엇이 들어 있는지 한눈에 살펴봅니다. 각 행은 아래의 상세 기능 개요로 연결됩니다.

영역	하이라이트
도구 프로필	search (약 3K 토큰, BM25 + 하이브리드 벡터 랭킹) · workflow (복합 스크립트) · full (735개 도구 전체)
브라우저 자동화	Chromium 및 Camoufox · 기존 타깃에 CDP 연결 · 안티 디텍션 프리셋 · 명시적 입력 CAPTCHA 솔버 · 팝업, 다운로드, 권한, 프로토콜 인터셉터
네트워크 인터셉션	HTTP/1.1 + HTTP/2 프레임 빌딩 · CA 자동 생성 MITM 프록시 · WebSocket 캡처 · GraphQL 인트로스펙션 헬퍼 · Burp Suite 브리지
JS 후킹 및 분석	LLM 기반 디오브푸스케이션 · 암호화 루틴 탐지 · AST 이해 · 소스맵 재구성 · 스크립트/스크립틀릿 추출 및 재생
WASM 리버스 엔지니어링	wabt 디스어셈블리 / C 트랜스파일레이션 (wasm2wat / wasm-decompile / wasm-objdump / wasm2c) · Binaryen wasm-opt · 순수 TS 섹션 파서 · 임포트/익스포트 목록 · 이름 섹션 복구를 포함한 섹션별 문자열 추출 · 함수 수준 바이너리 디프 · 난독화 탐지 · 함수 및 기본 블록 수준 계측
프로세스 및 메모리 포렌식	네이티브 FFI 스캐닝 · 상호 참조 그래프 · 하드웨어 브레이크포인트 · PE 인트로스펙션 · 라이브 프로세스 연결 · 영역 가드를 포함한 메모리 읽기/쓰기
바이너리 계측	Frida 브리지 · Ghidra 및 IDA 브리지 · 시스템 콜 후킹 · TLS 키로그 및 세션 도구 · Mojo IPC 분석
Android 및 APK 분석	APK 정적 트리아지 · 매니페스트 덤프 및 쿼리 · apktool 디코드 / 빌드 · jadx 디컴파일 및 코드 검색 · DEX 스캐닝 · 네이티브 라이브러리 목록 · APK 서명 · unidbg 에뮬레이션 · 런타임 DEX 덤프
네이티브 런타임	이종 아키텍처 샘플용 네이티브 에뮬레이터 · 플랫폼 인트로스펙션 · Mojo IPC · Dart Inspector · 온디바이스 트래픽용 ADB 브리지
인코딩 및 변환	URL/Base64/Hex/JWT/Protobuf 인코더 · AST 변환 · 스트리밍 디코드 파이프라인
조정	진행, 취소, 비동기 모드를 갖춘 백그라운드 작업 큐 · 멀티 에이전트 조정 · 커버리지 리포트
스키마 우선 메타 도구	describe_tool · 인자 검증을 포함한 call_tool · coverage_report · search_tools
플러그형 확장 레지스트리	핫 리로드 플러그인 · 선언적 워크플로 · 자동 발견 도메인

---

사용 사례

시나리오	수행 방법	관련 도메인
압축된 번들 훑어보기	search_tools → deobfuscate → search_in_scripts → understand_code	core
CAPTCHA 챌린지 리버싱	Camoufox 페이지 구동 → 스크린샷 → 명시적 입력으로 해결 → 재생	browser, canvas
OAuth 흐름 캡처 및 재생	proxy_start (자동 CA) → network_get_requests → graphql_introspect → graphql_replay	proxy, network, graphql
WASM 암호화 루틴 리버싱	wasm_dump → wasm_disassemble → generate_hooks → memory_breakpoint	wasm, binary-instrument, memory
의심스러운 APK 트리아지	apk_static_triage → apk_manifest_dump → jadx_decompile → dex_scan_file	binary-instrument
끊긴 브라우저 세션 복구	Streamable HTTP 재연결 → 활성화된 도메인 및 브라우저 상태 복원	browser, coordination
자격 증명을 위한 Node 프로세스 감사	process_list → memory_scan_filtered → binary_strings_extract	process, memory, binary-instrument
커스텀 워크플로 구축	list_extension_workflows → run_extension_workflow	workflow, extension-registry
라이브 프로세스의 함수 후킹	frida_spawn → frida_attach_interceptor → frida_run_script → frida_enumerate_functions	binary-instrument

---

빠른 시작

전역 설치가 필요 없습니다 — MCP 클라이언트 구성에 추가하면 바로 사용할 수 있습니다.

Claude Desktop / Cursor (claude_desktop_config.json):

{
  "mcpServers": {
    "jshook": {
      "command": "npx",
      "args": ["-y", "@jshookmcp/jshook@latest"],
      "env": {
        "MCP_TOOL_PROFILE": "search",
        "npm_config_omit": "optional"
      }
    }
  }
}

(Windows: npx를 찾을 수 없으면 npx.cmd 절대 경로를 사용하세요.)

이 경량 구성은 선택적 ONNX, Z3, Binaryen, Camoufox, Playwright 패키지를 건너뜁니다. 해당 풀 프로필 런타임이 필요하면 npm_config_omit를 제거하세요.

여러 에이전트 간에 하나의 데몬 공유

기본 stdio 구성은 MCP 호스트마다 하나의 전체 jshook 프로세스를 시작합니다. 임베딩 모델, 브라우저 런타임, 캐시를 공유하려면 하나의 로컬 Streamable HTTP 데몬을 시작하세요:

pnpm build
pnpm daemon

벡터 검색은 클라이언트별 stdio 프로세스에서는 기본적으로 꺼져 있고, 공유 HTTP 데몬에서는 (지연 로드로) 켜져 있습니다. 어휘 검색으로 충분하면 SEARCH_VECTOR_ENABLED=false로 설정하세요.