Dynamic Analysis MCP Gateway

An authenticated MCP gateway for localhost dynamic-analysis backends.

Supported backends:

• x64dbg-mcp-backend

• CE-mcp-backend

Windows installation

Run from an elevated PowerShell session using the release package:

.\install.ps1 `
  -Mode ServiceWithUserAgent `
  -X64dbgRoot 'C:\tools\x64dbg' `
  -CheatEngineRoot 'C:\tools\CE'

The installer reads the existing backend configurations, creates a boot-started Gateway service, and registers a per-user agent that starts at logon. It does not modify either backend installation.

For debugger-only installations, omit -CheatEngineRoot. For the explicit 0.0.0.0:8000 bearer-only plaintext HTTP profile behind a transparent host proxy, see single-machine LAN deployment. The default remains bearer-protected loopback HTTP.

GUI lifecycle operations are available only while the installing user is logged in. The Gateway endpoint remains online when that user is logged out.

Open a new terminal and register the public endpoint:

codex mcp add dynamic-analysis `
  --url http://127.0.0.1:8000/mcp `
  --bearer-token-env-var DYNAMIC_ANALYSIS_MCP_TOKEN

Installation, runtime behavior, hot patches, package upgrades, and uninstall commands are consolidated in the DBG operator guide. Configuration and secret handling are described in docs/configuration.md.

Related MCP server: Conduit

Development

Requirements: Node.js 24.20.0, npm 11.19.0, and Bun for the self-contained Windows executable.

npm ci
npm run check
npm run build
npm run build:exe
npm run test:install
npm run package:windows

The executable defaults to %ProgramData%\DynamicAnalysisMcpGateway\gateway.toml. Use --config <path> to select another file, --check-config to validate configuration, or --version to print the version.

Reference

• Architecture

• Backend naming compatibility

• Debugger restart contract