x64dbg MCP server

This plugin lets you interact with x64dbg from AI chat interfaces using the Model Context Protocol (MCP). It gives you access to over 40 debugger functions through natural language, making dynamic analysis more efficient by combining powerful debugging capabilities with conversational AI.

Installation

Prerequisites

• x64dbg debugger
• Claude Desktop or another MCP-compatible AI interface
• Python installed on your system

Setup Instructions

1. Install the x64dbg Plugin

   • Download the .dp64 file from the project's release directory
   • Copy this file to your x64dbg plugins folder: [x64dbg_installation_directory]/release/x64/plugins/

2. Configure the MCP Server

   • Download the x64dbgmcp.py script
   • Update your Claude Desktop configuration file (claude_desktop_config.json) with:

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

3. Verify Installation
   • Launch x64dbg
   • Start Claude Desktop
   • Check that the plugin loaded successfully by pressing ALT+L in x64dbg to view logs

Using the Plugin

The plugin allows you to control x64dbg through natural language commands in your AI chat interface. Here are some examples of what you can do:

Debug Control

You can control the debugger execution with simple commands:

Set a breakpoint at the main function and step through the first few instructions

Run the program until address 0x401000 and show me the state of registers

Memory Analysis

Examine and manipulate memory:

Read 100 bytes from address 0x401000 and show me what's there

Write the bytes 90 90 90 (NOP instructions) at the current instruction pointer

Register Operations

Check and modify CPU registers:

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

Set RCX to 0 and continue execution

Pattern Searching

Find byte patterns in memory:

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

Assembly and Disassembly

Work with assembly instructions:

Disassemble 10 instructions from the current RIP

Assemble a call instruction to address 0x401500 at the current position

Available Functions

The plugin supports over 40 x64dbg SDK functions, including:

Core Debug Control

• Execute any x64dbg command
• Check debugger status

Memory Management

• Read/write process memory
• Validate memory addresses
• Get memory protection flags

Debug Control

• Run, pause, and stop execution
• Step through code (step in, step over, step out)
• Set and delete breakpoints

Assembly & Disassembly

• Assemble instructions
• Disassemble code regions

Register and Flag Operations

• Read and write CPU registers
• Manipulate CPU flags (ZF, CF, etc.)

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "x64dbg" '{"command":"Path\\To\\Python","args":["Path\\to\\x64dbg.py"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect