Skip to main content

Model Context Protocol server for x64dbg debugger

Project description

Model Context Protocol for x64dbg Buy Me A Coffee

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

  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 / 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"
      ]
    }
  }
}
  1. 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

  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
  1. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_wasdubya_x64dbgmcp-1.0.0.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_wasdubya_x64dbgmcp-1.0.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

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

Hashes for iflow_mcp_wasdubya_x64dbgmcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 e6295df011fc84b805256335a7e0ce6b97ae17e971e8ecfb5d21571ab8066bf1
MD5 f69c2657b0f8ad9e914c8ac5d8ab8fd6
BLAKE2b-256 f8b2e85b83eaeaa3a087a08bac80741c171afae59e751edf3e382803e9e9582d

See more details on using hashes here.

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

Hashes for iflow_mcp_wasdubya_x64dbgmcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d1d9e39f5d99219c6de7a5062d64c040a2159431a4ddb276f4441e86d6328737
MD5 b99c3a32e8a0b69a88ab36feb7555c21
BLAKE2b-256 0bbbfbc187e6d4c3b7a924cb3f9c389ecf1ed5c7ad28b021bef73b5db3da0772

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page