wasdubya/x64dbgmcp

x64dbg MCP

다양한 LLMS(Claude 및 Cursor가 테스트됨)를 x64dbg 디버거와 브리지할 수 있는 MCP 서버로, 프롬프트를 통해 디버깅 애플리케이션에 직접 접근할 수 있습니다.
기능 (최신 자료는 소스 기반 빌드)

• 40+ x64dbg SDK 도구 - SDK가 제공하는 거의 모든 디버깅 기능에 접근해 스마트 디버깅을 지원합니다.
• 크로스 아키텍처 지원 - x64dbg와 x32dbg 모두에서 작동합니다.
• API 호환성 - python 파일에 제공된 args를 사용하여 cmd에서 재조정 가능.

3단계로 간단한 설정

1. 플러그인 다운로드

• 이 저장소의 빌드/릴리스 디렉터리에서 .dp64 또는 .dp32를 가져오세요
• 로컬로 복사하기: [x64dbg_dir]/release/x64/plugins/

2. **Claude Desktop 구성

• 이 저장소 src 디렉터리에서 x64dbgmcp.py 복사하여 다음을 보장하세요

• x64dbgmcp.py 경로로 로컬 claude_desktop_config.json을 업데이트합니다

3. 디버깅 시작

• x64dbg 발사
• Claude 데스크톱 시작
• 플러그인 로드 완료 확인 (로그용 x64dbg의 ALT+L 확인)

최신 기능을 위해 소스에서 빌드하세요!
** CMake와 MSVC는 설치되어 PATH에 있어야 합니다 **

• git clone https://github.com/wasdubya/x64dbgmcp
• CD x64dbgmcp
• cmake -S .

x64dbg MCP

Features (Build from Source for Latest)

• 40+ x64dbg SDK Tools - Provides access to almost every single debugging feature given by the SDK for smart debugging.
• Cross-Architecture Support - Works with both x64dbg and x32dbg.
• API Compatibility - Runable from cmd using the args given in the python file.

Quick Setup in 3 Steps

1. Download Plugin

• Grab .dp64 or .dp32 from this repo’s build/release directory
• Copy to your local: [x64dbg_dir]/release/x64/plugins/

2. Configure Claude Desktop

• Copy x64dbgmcp.py from this repos src directory, ensure to pip install mcp requests
• Update local claude_desktop_config.json with path to x64dbgmcp.py

{
  "mcpServers": {
    "x64dbg": {
      "command": "Path\\To\\Python",
      "args": [
        "Path\\to\\x64dbg.py"
      ]
    }
  }
}

3. Start Debugging
   • Launch x64dbg
   • Start Claude Desktop
   • Check plugin loaded successfully (ALT+L in x64dbg for logs)

Build from Source for Latest Features! ** CMake and MSVC should be installed and on PATH **

• git clone https://github.com/wasdubya/x64dbgmcp
• cd x64dbgmcp
• cmake -S . -B build (will resolve the pluginsdk automatically, so no need to worry about dependencies.)
• cmake --build build --target all_plugins --config Release (will build both 32 and 64 bit versions of the plugin)

TIP

1. Use the --target all_plugins argument to specify both x32 and x64, otherwise use -A flag to distinguish between either x64 or Win32 build. For example 32 bit build would be:

• cmake -S . -B build32 -A Win32 -DBUILD_BOTH_ARCHES=OFF
• cmake --build build32 --config Release

Usage Examples

Register inspection:

"What's the current value of RAX and RIP registers?"

Pattern searching:

"Find the pattern '48 8B 05' in the current module"

Example from Cursor

More Usage

• If you do not provide the model you are working with context of where your exe is, it wont have the capabiltiy to restart the binary if it crashes or hangs. So, provide it with the full path of the binary so it can call the CMDEXEC function like “init C:\Absolute\Path\to\EXE”.