Cheat Engine MCP server
2026년 11월 9일 커밋AI 클라이언트를 Cheat Engine 7.7에 연결하여 프로세스 조사, 메모리 및 코드 분석, Cheat Engine 워크플로 관리를 수행합니다.
다른 이름 CheatEngineNet/CheatEngine.Mcp, cheatengine-mcp
- 스타
- 101
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 9일
- 라이선스
- MIT
Cheat Engine MCP란?
AI 클라이언트를 Cheat Engine 7.7에 연결하여 프로세스 조사, 메모리 및 코드 분석, Cheat Engine 워크플로 관리를 수행합니다.
프로젝트 README에서 생성된 요약
Cheat Engine MCP server 정보
이 통합 기능은 메모리 분석 및 리버스 엔지니어링을 수행하는 개발자가 AI 클라이언트를 Cheat Engine 7.7 x64에 연결할 수 있도록 지원합니다. 전용 플러그인과 독립형 stdio 게이트웨이를 사용하여 AI가 Windows 머신에서 실행 중인 하나 또는 여러 개의 Cheat Engine 인스턴스와 상호작용할 수 있습니다. 설정 시 게이트웨이와 플러그인 사이에 인증된 루프백 HTTP 연결을 사용하므로, AI가 호스트를 검색하고 instance ID를 통해 특정 인스턴스로 명령을 전달할 수 있습니다.
사용자는 메모리 스캔, 포인터 맵 관리, 코드 디스어셈블리를 포함한 복잡한 워크플로를 관리할 수 있습니다. 이 서버는 구조체 정의, Mono 또는 .NET 타겟을 위한 심볼 해석, 디버거 작업 등 200개 이상의 도구를 제공합니다. 게이트웨이가 라우팅을 처리하므로, 각 프로세스에서 플러그인이 활성화되어 있고 동일한 Windows 사용자 계정으로 실행 중이라면 여러 Cheat Engine 프로세스를 동시에 관리할 수 있습니다. 이 설정을 올바르게 작동시키려면 .NET 10 런타임과 Cheat Engine 호스트의 특정 구성이 필요합니다.
활용 사례
- 1포인터 체인 관리AI에게 포인터 체인을 추적하고 검증하여 안정적인 메모리 주소를 찾도록 지시할 수 있습니다.
- 2어셈블리 및 디버깅 수행AI가 어셈블리 코드를 실행하거나 디버거 작업을 사용하여 실행 중인 소프트웨어를 조사할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능cheatenginenet/cheatengine.mcp is public and reachablegithub.com/cheatenginenet/cheatengine.mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-09github.com/cheatenginenet/cheatengine.mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기CheatEngine.Mcp
CheatEngine.Mcp is a Windows integration that connects MCP-compatible AI clients to Cheat Engine 7.7 x64. It provides structured tools for inspecting processes, analyzing memory and code, and managing Cheat Engine workflows. A plugin runs inside Cheat Engine; one standalone stdio gateway connects your client to one or more explicitly selected instances.
Download a matching plugin and gateway from Releases and follow that package's instructions. This README describes the current source; features may differ from the latest published build.
Capabilities · Installation · First use · Configuration · Troubleshooting · Development
Capabilities
The current source exposes 206 Cheat Engine tools, plus the gateway's instance_list tool.
| Area | Supported workflows |
|---|---|
| Processes and instances | Discover multiple hosts, page a stable process snapshot, select a target, and inspect modules, threads, and regions. |
| Memory | Read and write typed values and batches; sample values over time; compare, copy, hash, and snapshot bounded ranges. |
| Search | Run value scans and AOB searches; discover UTF-8 and UTF-16LE strings with filtering and pagination. |
| Pointers | Follow and validate chains with per-hop evidence; scan, rescan, and manage pointer maps. |
| Code analysis | Disassemble and decode instructions; inspect references, function graphs, and explicitly addressed vtable slots. |
| Structures and records | Define, compare, import, and export layouts; manage address-list records, freezes, and Cheat Engine tables. |
| Symbols and managed runtimes | Resolve and manage symbols; inspect supported Mono and .NET targets. |
| Investigation | Preserve versioned notes with observations, confidence, and module-relative bindings; search imported offline IL2CPP metadata. |
| Debugging and execution | Use supported debugger operations, patches, assembly, Lua, and compiled-code workflows subject to capability settings. |
| Session management | Inspect jobs and retained resources, monitor progress, and release or restore owned state. |
The tool map lists domains and capability requirements. The live MCP schema defines the exact arguments and results for the connected build. Runtime-specific tools require the corresponding Cheat Engine and target support; see Verification for the distinction between automated coverage and live qualification.
Feature contracts: persistent notes, offline IL2CPP, structure interchange, and process pagination.
How it works
AI client --stdio--> CheatEngine.Mcp.Gateway.exe
|
+-- authenticated loopback HTTP --> plugin in Cheat Engine A
+-- authenticated loopback HTTP --> plugin in Cheat Engine B
Each enabled plugin starts a backend on 127.0.0.1 with an automatically assigned port and a fresh access token.
It publishes a per-activation discovery record for the current Windows user.
The gateway verifies the backend's identity and routes calls by the explicit instanceId returned by instance_list.
It does not start Cheat Engine, select a process, or choose an instance for you.
Documents and prompts remain available through the gateway even when Cheat Engine is closed.
The default setup discovers instances automatically: no fixed port, backend URL, or manually configured access token is needed. Run the gateway and Cheat Engine under the same Windows user account.
Install and connect
1. Get the deployment files
Each packaged release uses CheatEngine.Mcp-<version>-win-x64.zip.
The ZIP includes CheatEngine.Mcp.dll, the gateway executable, installation instructions, and licenses.
Each release has one complete Windows x64 ZIP and SHA256SUMS.txt; separate plugin, skill, DLL, or EXE downloads are unnecessary.
When upgrading, disable the plugin, close Cheat Engine and the gateway, and remove the old plugin entry. Replace the plugin DLL and gateway executable with the matching files from one build; do not mix versions. Then add CheatEngine.Mcp.dll as described below. An old folder deployment is no longer needed.
To build the same layout from source, use the .NET SDK pinned in global.json, PowerShell 7, and the Windows C++ build tools required by Native AOT:
pwsh -NoProfile -File eng/Publish.ps1 -Configuration Release
The result is in artifacts/dist/release/:
| Item | Purpose |
|---|---|
CheatEngine.Mcp.dll |
Cheat Engine plugin, including its managed dependencies and native Lua bridge. |
CheatEngine.Mcp.Gateway.exe |
Standalone Windows x64 MCP server launched by your AI client. |
README.md |
Installation and configuration instructions. |
LICENSE and THIRD-PARTY-NOTICES.md |
License and dependency notices for the distribution. |
Copy these items together to a stable location, for example C:\Tools\CheatEngine.Mcp.
Keep the DLL name unchanged. No SDK DLL, Core DLL, plugin .deps.json, or plugin .runtimeconfig.json is installed beside it.
The plugin still needs the installed .NET 10 frameworks described below. Costura extracts the native Lua bridge to its per-user temporary cache when loading it.
A normal solution build creates development outputs; eng/Publish.ps1 creates the deployable layout and smoke-tests the gateway.
See Build from source for the full development commands.
2. Prepare Cheat Engine's .NET host
Use Cheat Engine 7.7 x64.
The plugin runs inside Cheat Engine and requires the x64 .NET 10, ASP.NET Core 10, and Windows Desktop 10 runtimes.
Check them with dotnet --list-runtimes; the output must include Microsoft.NETCore.App, Microsoft.AspNetCore.App, and Microsoft.WindowsDesktop.App at version 10.0.x.
The gateway executable is self-contained and does not use Cheat Engine's runtime configuration.
Cheat Engine's ce.runtimeconfig.json, beside its executable, must select .NET 10 and all three frameworks.
Close Cheat Engine and back up that file before changing it.
Preserve unrelated settings; a typical runtimeOptions section is:
{
"runtimeOptions": {
"tfm": "net10.0",
"rollForward": "LatestMinor",
"frameworks": [
{ "name": "Microsoft.NETCore.App", "version": "10.0.0" },
{ "name": "Microsoft.WindowsDesktop.App", "version": "10.0.0" },
{ "name": "Microsoft.AspNetCore.App", "version": "10.0.0" }
]
}
}
Restart Cheat Engine after changing this file. Installing .NET 10 alone does not change a host configuration that selects another major version.
3. Enable the plugin
In Cheat Engine, open Edit > Settings > Plugins, add the deployed CheatEngine.Mcp.dll, and enable it.
The menu bar shows MCP: Enabled after the backend starts and its instance is published.
Click the indicator for its instance name, listening address, and log location.
Enabling the plugin does not attach Cheat Engine to a target process.
Enable the plugin separately in every Cheat Engine process you want to use.
Leave the port at its default 0 so each process gets a free port.
4. Connect an AI client
Register one local stdio server whose command is the absolute path to CheatEngine.Mcp.Gateway.exe.
For Codex, for example:
codex mcp add cheatengine -- "C:\Tools\CheatEngine.Mcp\CheatEngine.Mcp.Gateway.exe"
codex mcp list
For a client that uses an mcpServers JSON object:
{
"mcpServers": {
"cheatengine": {
"command": "C:/Tools/CheatEngine.Mcp/CheatEngine.Mcp.Gateway.exe"
}
}
}
Use your client's equivalent command-based stdio setting if its format differs. Restart the client session after changing MCP registration. The client launches the gateway; double-clicking the executable does not configure a client. A remote or browser-only client needs a Windows-local component capable of launching the gateway.
First use
Ask the client to list Cheat Engine instances and inspect the selected target without changing memory. The intended call sequence is:
instance_list()returns verified plugin instances withinstanceId, display name, Cheat Engine process ID, and plugin version, plus aggregate diagnostics for missing or rejected instances.- Choose the intended instance and pass its exact
instanceIdtoruntime_get_infoandruntime_get_overview. - Check whether Cheat Engine has a target process open.
The instance's
processIdis Cheat Engine's PID; the target has its own PID. - Select a target in Cheat Engine or request a process attach through the tools exposed by the live MCP schema. Confirm the target before reading or changing it.
The gateway-local instance_list needs no instanceId; every routed Cheat Engine tool does.
There is no default or shared selected instance.
An empty list means the gateway is connected but has not found a verified, enabled plugin.
An ID changes when Cheat Engine restarts or the plugin is disabled and enabled again, so refresh instance_list before reusing one.
The server also offers the attach_and_orient guided prompt and the cheatengine://docs/getting-started resource.
The tool map describes tool domains and capability requirements; the live MCP schema is authoritative for this build's exact names and arguments.
Multiple Cheat Engine instances
Open more than one Cheat Engine process and enable the plugin in each.
One gateway discovers them all.
Display names may repeat, so select by the returned instanceId and Cheat Engine PID.
The default name includes the Cheat Engine PID.
To give each process a label, set MCP_INSTANCE_NAME before launching that process:
# First PowerShell window
$env:MCP_INSTANCE_NAME = 'game-a'
& 'C:\Program Files\Cheat Engine\cheatengine-x86_64.exe'
# Second PowerShell window
$env:MCP_INSTANCE_NAME = 'game-b'
& 'C:\Program Files\Cheat Engine\cheatengine-x86_64.exe'
These are display labels, not routing keys.
An instance that stops is never replaced automatically by another one, even when their labels match.
Keep Mcp:Port at 0; a fixed port must be unique across running instances.
The connection guide explains discovery and stale IDs in more detail.
Configuration
The defaults work without creating a file.
To change plugin settings, create %APPDATA%\CheatEngine.Mcp\appsettings.json and disable/re-enable the plugin.
The plugin reads, in increasing priority: built-in defaults, an optional appsettings.json beside the DLL, the user file, then the dedicated MCP_* environment overrides. No settings file is required for the default setup.
It reads settings once per activation.
Keep personal changes in the user file so updates preserve them.
A small optional user file looks like this:
{
"Mcp": {
"EnableUnsafeLua": false,
"Files": {
"AllowedRoots": ["C:\\CheatEngine\\Files"]
}
},
"CheatEngineClient": {
"AllowedTableRoots": ["C:\\CheatEngine\\Tables"]
}
}
The four capability switches EnableUnsafeLua, EnableAutoAssembler, EnableTargetCodeExecution, and EnableKernelAccess are true by default.
Set a switch to false to refuse its covered tools; runtime_get_info.gates reports the effective values.
The file and table allowed-root lists are empty by default, so host-file writes and table load/save need explicit local folders.
Capability switches refuse covered operations when disabled; they are not a sandbox for enabled operations.
See the configuration reference and safety guide for every key and its effect.
| Override | Used by | When to set it |
|---|---|---|
MCP_INSTANCE_NAME |
Plugin | Label one Cheat Engine process before launching it. |
MCP_DATA_DIRECTORY |
Plugin | Use a separate absolute directory for that process's user settings and logs. |
MCP_INSTANCE_DIRECTORY |
Plugin and gateway | Move the discovery registry; both sides must use the same absolute directory. |
MCP_HOST, MCP_PORT |
Plugin | Listener overrides; keep the loopback host and automatic port for normal use. |
MCP_GATEWAY_CALL_TIMEOUT_SECONDS |
Gateway | Set a routed-call timeout from 5 to 3600 seconds; default 45. |
The gateway also accepts --instance-directory <absolute path> and --call-timeout-seconds <5..3600>.
The call timeout includes discovery lookup, identity verification, connection setup and forwarding.
A timeout before forwarding reports not_started; after forwarding the host effect is unknown and the gateway never replays the operation.
Arguments override its environment variables.
If you move the registry, set MCP_INSTANCE_DIRECTORY for both the Cheat Engine and AI-client processes, or pass the matching directory to the gateway.
Do not set it to an empty value.
The default registry is %LOCALAPPDATA%\CheatEngine.Mcp\instances; its records contain access tokens and should stay private to the current user.
Tools, resources, and prompts
Tools return structured results, including operation-specific failures and partial outcomes. Some operations change Cheat Engine or target state; consult each tool's annotations, capability requirements, result, and cleanup guidance.
The gateway serves project knowledge as cheatengine://docs/{slug} resources and guided prompts even without a running plugin.
Examples include getting started, workflows, and errors and recovery.
With an instance selected, live resources expose read-only snapshots under cheatengine://instances/{instanceId}/....
Clients with resource completion support can suggest recently verified instance IDs and instance-specific names.
Resources created by MCP, such as named scans, jobs, allocations, and patches, have an activation lifetime.
Cheat Engine-owned state can persist after plugin disable.
Before switching targets or ending a session, inspect runtime_list_resources and use the relevant release or restore tools.
The session workflows describe cleanup and recovery.
Troubleshooting
| Symptom | Check |
|---|---|
| The client shows no CheatEngine.Mcp tools | Confirm the gateway path and stdio registration, then inspect the client's MCP startup log. The gateway writes diagnostics to stderr. |
instance_list is empty |
Enable the plugin in Cheat Engine, confirm MCP: Enabled, use the same Windows account, and check that both sides use the same instance directory. |
| Cheat Engine cannot load the plugin | Check Cheat Engine 7.7 x64, CheatEngine.Mcp.dll, all three x64 .NET 10 runtimes, and CE's ce.runtimeconfig.json. |
| One of several instances fails to start | Leave the port at 0, or give each process a distinct fixed port. |
| A previously working ID is unavailable | Refresh instance_list; restart and re-enable create new IDs. Do not redirect a failed call to another instance. |
| A tool reports no target | Select the intended target in Cheat Engine or attach through the chosen instance's process tools. |
| Attaching after opening a file is refused | Select the process in Cheat Engine or restart Cheat Engine before attaching again. The refusal preserves the open file. |
| A setting prevents enable | Correct the named Mcp key or MCP_* variable, then re-enable the plugin. |
| A routed call times out | Inspect the instance and the target before repeating a mutation; its host effect may be unknown. |
Plugin logs are written per Cheat Engine PID to %APPDATA%\CheatEngine.Mcp\CheatEngine.Mcp.<pid>.log, or to MCP_DATA_DIRECTORY when set.
A load failure can occur before that log exists.
See connection troubleshooting for status details and recovery steps.
Its support report checklist lists the versions, error fields and redacted excerpts to include when reporting a problem.
Updating or removing the installation
To update, finish task cleanup, close Cheat Engine, stop the client's MCP connection, and replace the plugin DLL and gateway together from one build.
Restart Cheat Engine, enable the plugin, reconnect the client, and refresh instance_list.
User settings survive because they are outside the distribution.
Keep the previous matching package and client registration as a rollback copy.
For a locked gateway, partial upgrade or rollback, follow the recovery steps before resuming work.
To remove the integration, release or manually restore task-owned state, disable the plugin, remove the gateway registration from the AI client, and then delete the deployment files. Disabling the plugin does not automatically undo every Cheat Engine-owned change.
Build from source
The repository pins its required .NET SDK in global.json.
PowerShell 7 and the Windows C++ build tools are needed for the Native AOT distribution.
Clone with git clone --recurse-submodules, or initialize the recorded dependency revisions from an existing checkout:
git submodule update --init --recursive
dotnet restore CheatEngine.Mcp.slnx --locked-mode
dotnet build CheatEngine.Mcp.slnx -c Release --no-restore
dotnet test --solution CheatEngine.Mcp.slnx -c Release --no-restore --no-build --filter-not-trait Category=LiveQualification --filter-not-trait Category=NativeLua --fail-skips on
pwsh -NoProfile -File eng/Publish.ps1 -Configuration Release
Client and SDK build from the Git submodules in externals/, with exact commits recorded by this repository.
They track upstream main; normal builds use the recorded commits and do not download a newer revision.
Other NuGet dependencies are centrally versioned in Directory.Packages.props and locked per project.
The plugin is framework-dependent inside Cheat Engine; the gateway is published as a self-contained Windows x64 Native AOT executable.
The contributor guide covers CI checks, formatting, contract snapshots, and packaging.
To build and package the standard release downloads, use:
pwsh -NoProfile -File eng/Release.ps1
This runs the publish pipeline and writes one verified ZIP plus SHA256SUMS.txt under artifacts/releases/<version>/.
To package an already published distribution without rebuilding it, pass -DistributionPath artifacts/dist/release.
For GitHub upload, that prebuilt distribution must also supply its sibling artifacts/dist/release.release-manifest.json and an independently reviewed SHA-256 digest; see Releases.
GitHub upload is explicit; see Releases.
Verification
Verification is split by the boundary being exercised:
| Layer | What it verifies |
|---|---|
| Portable tests | Tool behavior against Client doubles, input validation, contracts, resource limits, and real local HTTP/stdio routing. |
| Seeded fuzz tests | Bounded generated cases for value encoding, malformed input, pointer files, IL2CPP dumps, string discovery, vtables, and pointer chains. Seeds make failures reproducible. |
| NativeLua tests | The Lua bridge against a Lua 5.3 x64 DLL, without starting Cheat Engine or attaching to a target. |
| Live qualification | Known-value workflows in private Cheat Engine copies with disposable targets, plus isolation, restart, and cleanup checks. Requires explicit opt-in. |
| Distribution checks | Loading the bundled plugin in isolation and checking the published gateway's MCP protocol. |
The all-tool qualification report distinguishes positive adapter evidence, routing checks, expected refusals, and verified native behavior for each tool. A passing portable suite or successful routing call does not establish native success for every tool. See the test project guide and live qualification instructions for prerequisites and commands.
For 2.0, native qualification of six optional DBK/DBVM operations is deferred because a suitable environment is unavailable. They remain unqualified under their existing capability gates; this is an accepted release limitation. See the qualification scope for the affected operations and the remaining release gates.
Repository layout
| Project | Responsibility |
|---|---|
| Core | Shared composition, contracts, target state, and tool execution. |
| Tools | MCP tools grouped by Cheat Engine operation. |
| Resources | Embedded knowledge and live MCP resources. |
| Prompts | Guided workflows and server instructions. |
| Hosting | Backend hosting, discovery, and gateway routing. |
| Plugin | Cheat Engine entry point, activation lifecycle, Lua bridge, and logging. |
| Gateway | Stdio executable and composition root. |
| Tests | Contracts, offline integration, NativeLua, and live qualification. |
| LiveTarget | Disposable process used by live qualification. |
Each linked README documents its own project's layout, dependencies, and contribution boundaries.
Migration, contributing, and license
Version 2 is a breaking redesign of CeMCP 1.x. The plugin is now a single bundled DLL paired with the matching gateway executable; tool names and result contracts have changed, and instance routing is explicit. Consult the live tool schema when migrating scripts or prompts.
Use CheatEngine.Mcp only on software you own or are authorized to modify. Read SECURITY.md for the trust boundary and private vulnerability reporting, and CONTRIBUTING.md before submitting changes. The project is licensed under MIT; dependency licenses and attribution are in THIRD-PARTY-NOTICES.md.
Cheat Engine MCP 질문
CheatEngine.Mcp를 통해 AI 클라이언트가 무엇을 할 수 있나요?
MCP 호환 클라이언트에서 프로세스 조사, 메모리 및 코드 분석, Cheat Engine 워크플로 관리를 위한 도구를 사용할 수 있습니다.
어떤 Cheat Engine 버전을 지원하나요?
.NET 10, ASP.NET Core 10, Windows Desktop 10 런타임이 실행 중인 Cheat Engine 7.7 x64 버전이 필요합니다.
AI 클라이언트를 Cheat Engine에 어떻게 연결하나요?
CheatEngine.Mcp.Gateway.exe의 절대 경로를 명령어로 사용하는 로컬 stdio 서버를 하나 등록한 후, 클라이언트 세션을 재시작하십시오.
여러 개의 Cheat Engine 인스턴스를 동시에 사용할 수 있나요?
네, 각 Cheat Engine 프로세스에서 플러그인을 활성화하면 됩니다. 하나의 게이트웨이가 모든 인스턴스를 검색하며, instanceId를 통해 선택할 수 있습니다.
플러그인 접근 보안은 어떻게 유지되나요?
각 플러그인 백엔드는 자동으로 할당된 포트와 새로운 액세스 토큰을 사용하여 127.0.0.1에서 대기합니다.