zhizhuodemao/js-reverse-mcp

해결하는 문제

이 프로젝트는 JavaScript 리버스 엔지니어링을 위해 설계된 AI 네이티브 Model Context Protocol (MCP) 서버를 제공합니다. 이를 통해 AI 코딩 어시스턴트(Claude, Cursor, Copilot 등)가 웹 페이지 내의 JavaScript 동작을 디버깅, 탐색, 저장 및 분석할 수 있도록 하여 분석가 역할을 수행할 수 있게 합니다. 표준 DevTools API와 달리, 이 서버는 브라우저 기능을 AI 에이전트의 지속적인 추론 및 운영 흐름에 최적화된 도구로 재구성합니다.

작동 방식

서버는 AI 에이전트와 브라우저 인스턴스 사이의 가교 역할을 합니다. 프로토콜 수준에서 스텔스 기능을 제공하기 위해 Patchright의 특수 포크(fork) 버전을 사용하며, 고급 안티 봇 탐지를 우회하기 위해 소스 수준의 핑거프린트 패칭을 수행하는 CloakBrowser와 선택적으로 통합할 수 있습니다.

주요 아키텍처 선택 사항은 다음과 같습니다:

• Agent Primitives: 도구는 단순한 메뉴 매핑이 아닌 고수준 프리미티브(예: 파일 내보내기가 포함된 list_network_requests)로 설계되어 AI가 잘못된 단계에 갇히는 것을 방지합니다.
• Local File Integration: 에이전트가 스크립트와 네트워크 데이터를 로컬 파일로 저장할 수 있게 하여, 대량의 코드로 인해 채팅 컨텍스트가 과부하되는 것을 방지하기 위해 호스트 파일 시스템을 분석 워크벤치로 활용합니다.
• Stealth Layers: 페이지 수준의 JS 주입에 의존하지 않고 자동화 시그니처를 줄이기 위해 "silent navigation"(CDP 활성화 지연) 및 커스텀 Patchright 포크를 사용합니다.

대상 사용자

이 프로젝트는 AI 어시스턴트를 사용하여 JavaScript 리버스 엔지니어링을 수행하고, 네트워크 프로토콜(WebSocket 포함)을 분석하며, 복잡한 웹사이트의 안티 스크래핑/안티 봇 보호 기능을 우회하려는 개발자와 보안 연구원을 위해 구축되었습니다.

주요 특징

• AI-Native Toolset: 페이지 탐색, 스크립트 분석, 중단점 관리, 네트워크/WebSocket 검사 및 브라우저 상태 제어를 위한 24개의 특화된 도구.
• Advanced Anti-Detection: 프로토콜 스텔스 기능을 위한 커스텀 Patchright 포크와 심층적인 C++ 소스 수준 핑거프린트 패칭을 위한 선택적 --cloak 모드 포함.
• Contextual Debugging: 텍스트 검색 기반의 중단점 설정, 콜 프레임 검사 및 소스 컨텍스트를 에이전트에게 반환하며 코드를 단계별로 실행하는 기능 지원.
• State Management: 리스크 제어 흐름 및 쿠키 생성 프로세스를 재현하기 위해 사이트별 데이터(쿠키, 스토리지)를 삭제할 수 있는 기능.
• Persistent Sessions: 프로필을 통한 지속적인 로그인 상태 지원 및 CDP 엔드포인트를 통해 기존 Chrome 인스턴스 또는 타사 핑거프린트 브라우저에 연결할 수 있는 기능.