github CheatEngineNet/CheatEngine.Mcp v2.0.0-beta.1
CheatEngine.Mcp 2.0.0-beta.1

pre-release4 hours ago

CheatEngine.Mcp 2.0.0-beta.1

First public beta of the CheatEngine.Client-based MCP plugin and gateway for Windows x64.

Download

Recommended: CheatEngine.Mcp-2.0.0-beta.1-win-x64.zip. It contains:

  • CheatEngine.Mcp.dll: the CE plugin with its bundled managed dependencies and native bridge.
  • CheatEngine.Mcp.Gateway.exe: the self-contained stdio MCP gateway.
  • skills/cheatengine-mcp/: the separate optional AI skill, tool catalog, and operator guides.
  • INSTALL.md, README.md, appsettings.example.json, licenses, SHA256SUMS.txt, and VALIDATION.json.

The DLL and EXE are also attached individually. CheatEngine.Mcp-skill-2.0.0-beta.1.zip
contains the standalone skill folder. The release-level SHA256SUMS.txt covers all four assets.
GitHub's automatically generated source archives contain source code, not these prebuilt binaries.

Install

  1. Extract the complete Windows x64 ZIP into a stable directory.
  2. Install the x64 .NET 10, ASP.NET Core 10, and Windows Desktop 10 runtimes, then configure CE's ce.runtimeconfig.json for .NET 10 as shown in the README.
  3. In Cheat Engine 7.7 x64, add and enable CheatEngine.Mcp.dll under Edit > Settings > Plugins. Preserve its filename. Look for "MCP: Enabled" in CE's menu.
  4. Configure your AI client's stdio MCP server command to point to CheatEngine.Mcp.Gateway.exe. For Codex: codex mcp add cheatengine -- "C:\Tools\CheatEngine.Mcp\CheatEngine.Mcp.Gateway.exe" (adjust the path), then restart the client/session.
  5. Optionally copy the complete skills/cheatengine-mcp folder to your AI client's skill directory. For Codex: %USERPROFILE%\.agents\skills\cheatengine-mcp.

No SDK or source build is needed for the prebuilt download. Cheat Engine and its host
runtimes are not included. The gateway includes its own runtime. See the included
INSTALL.md and the full installation guide.

Included workflows

  • One MCP connection routing to multiple explicit Cheat Engine instances.
  • Process attachment, memory reads/writes, address-list editing, freezing, and speedhack controls.
  • Value scans synchronized with CE's visible scan tab, plus independent named scanners.
  • Pointer snapshots/rescans, disassembly, debugger captures, Lua, and Auto Assembler tools.
  • JSON configuration and a visible enabled/disabled backend status in Cheat Engine.

Validation

  • Release build: zero warnings and errors.
  • Unit, transport, and native Lua tests: 211 passed, 0 failed, 0 skipped.
  • Live qualification of the exact attached DLL and EXE on CE 7.7.1.10828: 1 passed, 0 failed, 0 skipped.
  • The live scenario used two private CE instances and separate disposable targets through one gateway. It checked discovery, loaded paths, memory operations, address-list freeze/unfreeze, speedhack readback, visible/independent scanner isolation, disassembly, and shutdown isolation.
  • CE user settings were restored, the installed CE source was unchanged, and cleanup reported no failures.
  • Bundle writer and style/whitespace checks passed. Binary hashes and test scope are included in VALIDATION.json.

Beta limitations

This is a prerelease for testing. Validation does not cover every exposed tool,
every MCP client, clean-machine installation, all debugger backends, or DBVM.
Speedhack readback does not establish timing accuracy. Pointer maps are bounded MCP
snapshots, not CE's native pointer-map files. The main scanner retains CE's visible
memory range and filtering options.

CE 7.7's VEH debugger crashed during an observed second attachment to the same target.
MCP guards that sequence; restart the target before reattaching. See the included
scanning-and-debugging guide. Lua, Auto Assembler, and dedicated mutation tools are
enabled by default; explicit configuration can disable Lua or Auto Assembler.

Source commit: 93d19d0.

Don't miss a new CheatEngine.Mcp release

NewReleases is sending notifications on new releases.