Model Context Protocol server for x64dbg debugger
Project description
Model Context Protocol for x64dbg
An MCP server that can bridge various LLMS with the x64dbg debugger, providing direct access to debugging functionality through prompts!
Features
- 40+ x64dbg SDK Tools - Provides access to almost every debugging feature given by the SDK for smart debugging.
- Cross-Architecture Support - Works with both x64dbg and x32dbg.
- API Compatibility - (Disclaimer: As of 8-2025, Anthropic added rate limiting to their messages API, super harsh on free tiers. I recommend using models from Cursor UI)
- Provides API access to Claude from CMD for even faster debugging and longer consecutive tool chain calls.
- Runable from cmd using the args given in the python file. (API Key, max tool calls, etc.)
- IF you have issues connecting to the x64dbg session from the python file, open the logs tab in x64dbg to view what port the plugin is running on and add that as the argument to your python script.
Quick Setup
-
Download Plugin
- Grab .dp64 or .dp32 from this repo's build/release directory
- Copy to your local: [x64dbg_dir]/release/x64/plugins/
-
Configure Claude / MCP Supported App
- Copy x64dbgmcp.py from this repos src directory
- Update local claude_desktop_config.json with path to x64dbgmcp.py
{
"mcpServers": {
"x64dbg": {
"command": "Path\\To\\Python",
"args": [
"Path\\to\\x64dbg.py"
]
}
}
}
- Start Debugging
- Launch x64dbg
- Start Claude Desktop
- Check plugin loaded successfully (ALT+L in x64dbg for logs)
Build from Source
- git clone [repository-url]
- cd x64dbgmcp
- cmake -S . -B build
- cmake --build build --target all_plugins --config Release
Tips
- 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
- If you do not provide the model you are working with 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"
This will allow for even more automated analysis.
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iflow_mcp_wasdubya_x64dbgmcp-1.0.0.tar.gz.
File metadata
- Download URL: iflow_mcp_wasdubya_x64dbgmcp-1.0.0.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e6295df011fc84b805256335a7e0ce6b97ae17e971e8ecfb5d21571ab8066bf1
|
|
| MD5 |
f69c2657b0f8ad9e914c8ac5d8ab8fd6
|
|
| BLAKE2b-256 |
f8b2e85b83eaeaa3a087a08bac80741c171afae59e751edf3e382803e9e9582d
|
File details
Details for the file iflow_mcp_wasdubya_x64dbgmcp-1.0.0-py3-none-any.whl.
File metadata
- Download URL: iflow_mcp_wasdubya_x64dbgmcp-1.0.0-py3-none-any.whl
- Upload date:
- Size: 9.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d1d9e39f5d99219c6de7a5062d64c040a2159431a4ddb276f4441e86d6328737
|
|
| MD5 |
b99c3a32e8a0b69a88ab36feb7555c21
|
|
| BLAKE2b-256 |
0bbbfbc187e6d4c3b7a924cb3f9c389ecf1ed5c7ad28b021bef73b5db3da0772
|