@jshookmcp/jshook

English | 中文

AI 기반 JavaScript 분석 및 보안 분석을 위한 내장 도구 카탈로그를 갖춘 런타임 레지스트리 기반의 MCP(Model Context Protocol) 서버입니다. 브라우저 자동화, Chrome DevTools Protocol 디버깅, 네트워크 모니터링, 지능형 JavaScript 후킹, LLM 기반 코드 분석, 프로세스 및 메모리 검사, WASM 도구, 소스 맵 재구성, AST 변환 및 복합 워크플로우를 단일 서버에서 결합합니다.

문서 / 빠른 링크

• 📖 문서 읽기

• 🚀 시작하기

• ⚙️ 설정

• 📚 도구 참조

🚀 빠른 시작

전역적으로 아무것도 설치할 필요 없이 Claude Desktop 또는 Cursor에서 즉시 jshookmcp를 사용하세요.

Claude Desktop 설정 (claude_desktop_config.json):

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

(Windows 사용자 참고: npx를 찾을 수 없는 경우 npx.cmd의 절대 경로를 지정하세요)

🌟 주요 특징

• 🤖 AI 기반 분석: 지능형 JavaScript 난독화 해제, 암호화 알고리즘 탐지 및 AST 수준의 코드 이해를 위해 LLM을 활용합니다.

• ⚡ 검색 우선 컨텍스트 효율성: BM25 기반의 search_tools + 동적 부스트를 통해 jshook의 도구 스키마 초기화 델타를 약 40.0K+ 토큰(full)에서 약 3.0K(search)로 줄였습니다 (Claude 서버 측 카운트; Claude Code 기본 프롬프트 제외).

• 🎯 단계별 기능 계층: 세 가지 내장 프로필(search/workflow/full)을 제공하며, search는 온디맨드 기능 확장을 위한 기본 계층으로 사용됩니다.

• 🌐 풀스택 자동화: Chromium/Camoufox 브라우저, CDP 디버깅 및 네트워크 인터셉션을 원활하게 원자적 작업으로 오케스트레이션합니다.

• 🛡️ 고급 안티 디버그: debugger 문, 타이밍 검사 및 엄격한 헤드리스 봇 핑거프린팅 기술에 대한 내장 회피 기능을 제공합니다.

• 🧩 동적 확장성: 코어 서버를 재컴파일하지 않고도 로컬 디렉토리에서 플러그인과 워크플로우를 핫 리로드합니다.

• 🔧 제로 와이어링 확장성: manifest.ts를 통한 자동 도메인 검색, 지연 핸들러 인스턴스화 및 플러그인/워크플로우를 위한 B-Skeleton 계약을 지원합니다.

• 🛠️ 리버스 엔지니어링 툴체인: 통합 WASM 디스어셈블리, 바이너리 엔트로피 분석, 메모리 내 스캔 및 Burp Suite/Ghidra/IDA Pro를 위한 브릿지를 제공합니다.

🛡️ 핵심 기능

JSHookMCP는 36개 도메인에 걸쳐 360개 이상의 원자적 도구를 노출하여 AI 오케스트레이터에게 독보적인 기능을 제공합니다:

• 🕸️ 브라우저 자동화 및 리버스 엔지니어링: 제로 설정 Chromium/Camoufox 주입, CDP(Chrome DevTools Protocol) 오케스트레이션 및 iframe 평가 우회.

• 📡 네트워크 인터셉션 및 스푸핑: 심층 HTTP/2 프레임 빌딩, MiTM 트래픽 캡처, GraphQL 인트로스펙션 및 Burp Suite 브릿지.

• 🧠 AST 및 의미론적 분석: LLM 기반 난독화 해제, WebAssembly(WASM) 디스어셈블리, 소스 맵 재구성 및 바이너리 엔트로피 시각화.

• 🧰 프로세스 및 메모리 포렌식: 네이티브 Frida 계측, 메모리 스캔, 포인터 역참조 및 엄격한 안티 디버그 완화.

• 🔌 동적 확장성: 핫 리로드 가능한 B-Skeleton 플러그인 및 선언적 WorkflowContract 파이프라인.

전체 36개 도메인 도구 카탈로그 보기 ↗

아키텍처 및 성능

• 점진적 도구 검색: search_tools 메타 도구(BM25 랭킹) + activate_tools / activate_domain + 프로필 기반 계층 업그레이드(boost_profile)

• 검색 계층 동작: search_tools는 결과 검색 및 순위 지정만 수행하며, activate_tools를 자동 실행하거나 boost_profile을 자동 실행하지 않습니다. 권장 체인: search_tools -> activate_tools / activate_domain -> boost_profile (필요한 경우에만)

• 단일 도구에 대한 부스트 금지: activate_tools는 현재 기본 계층에서 계층 전반의 정확한 도구를 등록할 수 있습니다. boost_profile은 관련 도구의 광범위한 제품군을 반복적으로 재사용할 것으로 예상될 때 더 좋습니다.

• 지연 도메인 초기화: 핸들러 클래스는 시작 시점이 아닌 첫 호출 시 Proxy를 통해 인스턴스화됩니다.

• 도메인 자체 검색: 런타임 매니페스트 스캔(domains/*/manifest.ts)이 하드코딩된 임포트를 대체합니다. 단일 매니페스트 파일을 생성하여 새 도메인을 추가하세요.

• B-Skeleton 계약: 플러그인(PluginContract), 워크플로우(WorkflowContract) 및 관측 가능성(InstrumentationContract)을 위한 확장성 계약.

• MCP ToolAnnotations: 모든 도구는 의미론적 주석(readOnlyHint, destructiveHint, idempotentHint, openWorldHint)을 포함하여 AI 오케스트레이터가 호출 전 도구의 안전성과 부작용을 추론할 수 있도록 합니다.

레지스트리 스냅샷

아래의 내장 표면은 런타임 레지스트리에서 생성되며 CI에서 확인됩니다.

• 패키지 버전: 0.3.0

• 내장 도구: 387

• 도메인: adb-bridge, antidebug, binary-instrument, boringssl-inspector, browser, canvas, coordination, core, cross-domain, debugger, encoding, evidence, extension-registry, graphql, hooks, instrumentation, macro, maintenance, memory, mojo-ipc, network, platform, process, protocol-analysis, proxy, sandbox, shared-state-board, skia-capture, sourcemap, streaming, syscall-hook, trace, transform, v8-inspector, wasm, workflow

• 참고: 이 스냅샷은 런타임 레지스트리에서 생성되었습니다. 수동으로 카운트를 편집하지 마십시오.

전체 도구 참조 보기 ↗

프로젝트 통계

Star 기록