SetsunaYukiOvO/x64dbg-mcp

해결하는 문제

이 프로젝트는 x64dbg/x32dbg 디버거와 AI 에이전트 사이의 다리를 제공합니다. 외부 애플리케이션과 AI 모델이 표준화된 프로토콜을 통해 디버거를 프로그래밍 방식으로 제어하고, 실시간으로 바이너리 실행을 분석하고 역어셈블리 작업을 수행할 수 있게 해줍니다.

작동 방식

이 프로젝트는 x64dbg 및 x32dbg용 플러그인으로, Model Context Protocol (MCP)를 구현합니다. 기본적으로 포트 3000을 사용하는 HTTP 서버를 시작하여 JSON-RPC 2.0 인터페이스를 노출합니다. 이를 통해 AI 에이전트는 세 가지 핵심 구성 요소를 통해 디버거와 상호작용할 수 있습니다:

• Tools: 실행 제어(실행/일시정지/스텝), 메모리 및 레지스터 접근, 브레이크포인트 관리, 디어셈블리 등 AI가 호출할 수 있는 79개의 함수.
• Resources: 디버거 상태, 레지스터, 모듈, 메모리 맵에 대한 AI 접근을 제공하는 15개의 컨텍스트 제공자.
• Prompts: 크래시 분석, 취약점 탐지, 바이너리 언패킹 등 일반적인 작업용 10개의 워크플로우 템플릿.

대상 사용자

x86/x64 바이너리의 디버깅 및 분석을 AI 에이전트(Cursor 등 MCP 호환 클라이언트)를 사용해 자동화하고 보조하고자 하는 역어셈블리 엔지니어, 보안 연구자, 개발자.

주요 특징

• 포괄적인 제어: 실행, 메모리, 레지스터, 스레드 관리에 대한 완전한 접근 권한.
• 이중 아키텍처 지원: x64 및 x86 아키텍처 모두에서 작동.
• MCP 활용: AI 도구와의 간편한 통합을 가능하게 하는 Model Context Protocol에 완전히 준수.
• 보안 우선: 권한 기반 접근 제어 및 선택적 Bearer 토큰 인증을 통해 비인가된 디버거 제어를 방지.
• 통합 워크플로우 템플릿: OEP 탐지 및 알고리즘 역전과 같은 복잡한 작업용 사전 정의된 프롬프트.