miscusi-peek / cheatengine-mcp-bridge

Demo
# Cheat Engine MCP Bridge
**Let multibillion $ AI datacenters analyze the program memory for you.**
Create mods, trainers, security audits, game bots, accelerate RE, or do anything else with any program and game in a fraction of a time.
> [!NOTE]
> Thanks everyone for the stars, much appreciated! 
> Specially a big thank you to all the contributors!!
> 
> @libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive
---
## The Problem
You're staring at gigabytes of memory. Millions of addresses. Thousands of functions. Finding *that one pointer*, *that one structure* takes **days or weeks** of manual work.
**What if you could just ask?**
> *"Find the packet decryptor hook."* 
> *"Find the OPcode of character coordinates."* 
> *"Find the OPcode of health values."* 
> *"Find the unique AOB pattern to make my trainer reliable after game updates."*
**That's exactly what this does.**
_- Stop clicking through hex dumps and start having conversations with the memory._
---
## What You Get:
| Before (Manual) | After (AI Agent + MCP) |
|-----------------|---------------------|
| Day 1: Find packet address | Minute 1: "Find RX packet decryption hook" |
| Day 2: Trace what writes to it | Minute 3: "Generate unique AOB signature to make it update persistent" |
| Day 3: Find RX hook | Minute 6: "Find movement OPcodes" |
| Day 4: Document structure | Minute 10: "Create python interpreter of hex to plain text" |
| Day 5: Game updates, start over | **Done.** |
**Your AI can now:**
- Read any memory instantly (integers, floats, strings, pointers)
- Follow pointer chains: `[[base+0x10]+0x20]+0x8` → resolved in ms
- Auto-analyze structures with field types and values
- Identify C++ objects via RTTI: *"This is a CPlayer object"*
- Disassemble and analyze functions
- Debug invisibly with hardware breakpoints + Ring -1 hypervisor
- And much more!
---
## How It Works
 [code] 
---
## Installation
 [code] 
Or manually:
 [code] 
> [!NOTE]
> Native pipe mode is **Windows only** because it uses Named Pipes (`pywin32`). Use TCP relay transport when the MCP server runs outside the Windows environment that hosts Cheat Engine and cannot open the named pipe directly.
---
## Quick Start
### 1. Load Bridge in Cheat Engine
1. Enable DBVM in Cheat Engine if you plan to use DBVM tools.
2. Open Cheat Engine's Lua Engine or script executor.
 - Preferred: `File` -> `Execute Script` -> open `MCP_Server/ce_mcp_bridge.lua` -> `Execute`.
 - If your Cheat Engine build does not show `File` -> `Execute Script`, use `Table` -> `Show Cheat Table Lua Script`, paste the `dofile(...)` line below, and execute it:
 [code] 
Look for: `[MCP v12.0.0] MCP Server Listening on: CE_MCP_Bridge_v99`
### 2. Configure MCP Client
Add to your MCP configuration (e.g., `mcp_config.json`):
 [code] 
Restart the IDE to load the MCP server config.
For Codex, add a TOML server block to `~/.codex/config.toml`:
 [code] 
Use single quotes for the Windows path so TOML treats backslashes literally.
#### TCP relay transpo