# Clone the repository
git clone https://github.com/Zekiog/z-x64dbg-mcp.git
cd z-x64dbg-mcp

# Run the unified installer
.\install.ps1

# Zig build (native, recommended)
zig build run

# Or TypeScript (npm ecosystem)
cd server
npm install
npm start

{
  "mcpServers": {
    "z-x64dbg": {
      "command": "node",
      "args": ["/path/to/z-x64dbg-mcp/server/dist/index.js"],
      "env": {
        "X64DBG_HOST": "localhost",
        "X64DBG_PORT": "31964"
      }
    }
  }
}

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   AI Client     │────▶│  MCP Server      │────▶│  x64dbg Plugin  │
│  (Claude Code)  │◀────│ (Zig/TypeScript) │◀────│  (C++ Bridge)   │
└─────────────────┘     └──────────────────┘     └─────────────────┘
         │                       │                        │
         │  MCP Protocol         │  REST API              │  Debugger
         │  (stdio/SSE/HTTP)     │  (localhost:31964)     │  Events

zig build
zig build run

cd server
npm install
npm run build
npm start

cd plugin
mkdir build && cd build
cmake .. -G "Visual Studio 17 2022"
cmake --build . --config Release

# Run test suite
npm test

# Integration tests
npm run test:integration

{
  "tool": "x64dbg.set_breakpoint",
  "arguments": {
    "address": "0x140001000",
    "type": "hardware",
    "condition": "rax == 0x42"
  }
}