x64dbg MCP Server

당신의 AI로 x64dbg를 구동하세요. Claude, Cursor, Windsurf, Cline 또는 어떤 MCP 클라이언트에게 평범한 영어로 말하면, 중단점을 설정하고, 메모리를 읽고, 디스어셈블하고, 추적하고, PE를 덤프하고, 안티디버깅을 우회합니다 — 디버거 내부에서 실시간으로.

153개의 REST 엔드포인트를 갖춘 23개의 메가 툴이며, Zod로 완전히 타입이 지정되어 있습니다. C++ 플러그인이 x64dbg 내부에서 실행되고, 작은 TypeScript 서버가 stdio를 통해 클라이언트와 연결합니다. 모든 것은 127.0.0.1에 머무르므로, 어떤 것도 여러분의 컴퓨터 밖으로 나가지 않습니다.

최신 — v2.3.0

• 강화 및 크래시 방지. 잘못된 형식의 HTTP 요청이 더 이상 x64dbg를 크래시시킬 수 없습니다. 플러그인 서버는 중지 시 연결을 깔끔하게 정리하고 선택적 인증 토큰을 제공합니다 (CORS는 잠겨 있습니다).

• 더 많은 도구에서 실제 데이터 제공. imports/exports, symbols 검색/목록, patches 목록 및 strings는 이제 GUI 보기를 가리키는 대신 실제 파싱된 결과를 반환합니다.

• 실시간 추적 상태. 새로운 /api/trace/status (+ tracing status)는 추적 실행 여부를 보고하며, 예외/추적 도구는 이제 수용하는 모든 매개변수를 존중합니다.

• 또한 v2.2.x 수정 사항: x32dbg가 최신 스냅샷에서 로드되고, 긴 작업 중 요청이 더 이상 시간 초과되지 않습니다.

v2.3.0 플러그인 다운로드 →

실제 사용 모습

"Set a breakpoint on CreateFileW and run the program"
"Disassemble the current function and explain what it does"
"Search for 48 8B ?? 48 85 C0 in the main module and disassemble the hits"
"Hide the debugger and bypass the anti-debug checks"
"Trace into the VM dispatcher and log every instruction to a file"
"Dump the main module to disk and fix the import table"

실제 사용: VMProtect로 보호된 코드 추적, 안티치트 스캐너 스레드 찾기, XOR로 인코딩된 클래스 이름 디코딩, 탐지 로직 매핑 — 모두 질문만으로 이루어지며, 수동 스크립팅이 필요 없습니다.

설치

1 · 플러그인 (x64dbg 내부)

다운로드 최신 릴리스에서 x64dbg_mcp.dp64 / .dp32를 받아 다음 위치에 넣으세요:

x64dbg/x64/plugins/x64dbg_mcp.dp64    ← 64-bit targets
x64dbg/x32/plugins/x64dbg_mcp.dp32    ← 32-bit targets

…또는 직접 빌드 + 설치하세요 (x64dbg를 자동 감지하므로 경로 편집이 필요 없습니다):

.\build.ps1 -Install

x64dbg를 시작하면 로그에 [MCP] x64dbg MCP Server started on 127.0.0.1:27042가 표시됩니다.

2 · 서버 (AI 클라이언트)

설치 불필요 — 클라이언트를 npx로 지정하기만 하면 됩니다. Claude Code:

{
  "mcpServers": {
    "x64dbg": {
      "type": "stdio",
      "command": "cmd",
      "args": ["/c", "npx", "-y", "x64dbg-mcp-server"]
    }
  }
}

Claude Desktop / Cursor / Windsurf / Cline은 cmd /c 래퍼 없이 동일한 블록을 사용합니다: { "command": "npx", "args": ["-y", "x64dbg-mcp-server"] }. 클라이언트별 전체 경로는 참조 문서에 있습니다.

3 · 시작하기

x64dbg에서 대상을 열고 어시스턴트와 대화를 시작하세요.

도구 한눈에 보기

디버거 전체를 아우르는 23개의 액션 기반 도구:

• 컨트롤 — 실행/스텝/일시정지, 원시 명령, 스크립트, 표현식 평가

• CPU 및 메모리 — 레지스터 (AVX-512 포함), 읽기/쓰기/할당/보호, 메모리 맵

• 스택 — 호출 스택, SEH 체인, 반환 주소

• 코드 분석 — 디스어셈블, 어셈블, 크로스 레퍼런스, 기본 블록, CFG, 루프

• 중단점 및 추적 — 소프트웨어/하드웨어/메모리/조건부/로깅, 배치, 추적 로그

• 심볼 및 검색 — 레이블, 주석, 북마크, AOB 패턴 + 문자열 스캔

• 프로세스 및 시스템 — 스레드/TEB, 핸들, TCP, PEB, 안티디버깅 숨기기

• 패치 및 덤프 — 바이트 패치, PE 덤프, IAT 수정, 패치 내보내기

모든 도구, 액션 및 엔드포인트는 **docs/REFERENCE.md**에 문서화되어 있습니다.

링크

• 전체 참조 — 도구, 아키텍처, 빌드, 구성, 문제 해결

• npm: x64dbg-mcp-server

• 릴리스 — 사전 빌드된 플러그인 DLL

• x64dbg — 디버거

보안

플러그인은 127.0.0.1에만 바인딩되며, 서버는 순수 stdio로 통신합니다. 모든 트래픽은 localhost에 유지됩니다 — 원격 액세스도, 텔레메트리도 없으며, 데이터가 컴퓨터 밖으로 나가지 않습니다. 다른 로컬 프로세스로부터 방어하려면 플러그인의 설정에서 토큰을 설정하고 X64DBG_MCP_TOKEN을 통해 전달하세요. 그러면 모든 요청에 토큰이 포함되어야 합니다.

작성자

bromo — GitHub. Claude Code로 제작되었습니다. MIT.