MCP Cheat Engine Server Documentation

If you find this useful, please ⭐ star the repo — it helps others discover it!

📋 Table of Contents

1. Overview
2. Quick Start Guide
3. Installation
4. Configuration
5. Using the Tools
6. Safety & Security
7. Troubleshooting
8. Advanced Usage
9. API Reference
10. FAQ

🎯 Overview

The MCP Cheat Engine Server provides safe, structured access to memory analysis and debugging functionality through the Model Context Protocol (MCP). This tool is designed for:

• Software developers debugging applications
• Security researchers analyzing programs
• Students learning about computer memory and reverse engineering
• Game modders understanding game mechanics

⚠️ Important Safety Notice

This server operates in READ-ONLY mode for safety. It can read and analyze memory but cannot modify it. All operations are logged for security auditing.

🔧 Key Features

• ✅ Process enumeration and attachment
• ✅ Memory reading with multiple data types
• ✅ Pattern scanning and searching
• ✅ Assembly code disassembly
• ✅ Pointer chain resolution
• ✅ Cheat Engine table (.CT) import
• ✅ Safe Lua script analysis
• ✅ Comprehensive security controls

🚀 Quick Start Guide

Prerequisites

• Windows 10/11 (64-bit recommended)
• Python 3.9 or higher
• Administrator privileges (for memory access)
• Claude Desktop or compatible MCP client

30-Second Setup

1. Download the server files to your computer
2. Open PowerShell as Administrator
3. Navigate to the server directory
4. Install dependencies: pip install -r requirements.txt
5. Start the server: python server/main.py

First Use

1. List processes: Use the list_processes tool to see available programs
2. Attach to a process: Use attach_to_process with a process ID
3. Read memory: Use read_memory_region to examine memory
4. Detach safely: Use detach_from_process when done

🔌 Claude Desktop MCP Setup

📖 For detailed Claude Desktop setup instructions, see MCP_SETUP.md

Quick configuration summary:

1. Find your Claude Desktop config: %APPDATA%\Claude\claude_desktop_config.json (Windows)
2. Add the MCP server configuration:

{
  "mcpServers": {
    "cheat-engine": {
      "command": "python",
      "args": ["path\\to\\server\\main.py", "--debug", "--read-only"],
      "cwd": "path\\to\\cheat-engine-server-python"
    }
  }
}

3. Restart Claude Desktop
4. Test: Ask Claude to "list processes using the MCP server"

📦 Installation

Step 1: System Requirements

• Operating System: Windows 10/11 (Primary), Linux/macOS (Limited)
• Python Version: 3.9, 3.10, 3.11, or 3.12
• Memory: 4GB RAM minimum, 8GB recommended
• Permissions: Administrator/root access required

Step 2: Download and Setup

# Clone or download the project
cd C:\your-desired-location
# Extract files if downloaded as ZIP

# Navigate to project directory
cd cheat-engine-server-python

# Verify Python version
python --version

Step 3: Install Dependencies

# Install required packages
pip install -r requirements.txt

# Verify installation
python -c "import mcp, trio, psutil, capstone; print('All dependencies installed successfully!')"

Step 4: Test Installation

# Test the server
python server/main.py --test

# You should see: "MCP Cheat Engine Server initialized successfully"

⚙️ Configuration

Basic Configuration

The server uses configuration files in the server/config/ directory:

settings.json (Auto-created on first run)

{

... [View full README on GitHub](https://github.com/bethington/cheat-engine-server-python#readme)