عرض توضيحي

Cheat Engine MCP Bridge

دع مراكز بيانات الذكاء الاصطناعي متعددة المليارات تحلل ذاكرة البرنامج نيابةً عنك.

أنشئ تعديلات (mods)، وأدوات تدريب (trainers)، وتدقيقات أمان، وروبوتات ألعاب، وسرّع الهندسة العكسية (RE)، أو افعل أي شيء آخر مع أي برنامج ولعبة في جزء يسير من الوقت.

[!NOTE] شكراً لكم جميعاً على النجوم، محل تقدير كبير! <3

وبشكل خاص، شكر كبير جداً لجميع المساهمين!!

@libangli218, @lauralex, @iamtyroon, @HachiroSan, @Attacktive

---

المشكلة

أنت تحدّق في غيغابايتات من الذاكرة. ملايين العناوين. آلاف الدوال. العثور على ذلك المؤشر المحدد، ذلك الهيكل المحدد يستغرق أياماً أو أسابيع من العمل اليدوي.

ماذا لو كان بإمكانك أن تسأل فقط؟

"اعثر على خطاف فك تشفير الحزم."
"اعثر على OPcode لإحداثيات الشخصية."
"اعثر على OPcode لقيم الصحة."
"اعثر على نمط AOB الفريد لجعل أداة التدريب موثوقة بعد تحديثات اللعبة."

هذا بالضبط ما يفعله هذا المشروع.

- توقف عن التنقيب في مفرغات الهكس (hex dumps) وابدأ في إجراء محادثات مع الذاكرة.

---

ما الذي ستحصل عليه:

قبل (يدوي)	بعد (وكيل ذكاء اصطناعي + MCP)
اليوم 1: العثور على عنوان الحزمة	الدقيقة 1: "اعثر على خطاف فك تشفير حزم RX"
اليوم 2: تتبّع ما يكتب إليه	الدقيقة 3: "ولّد توقيع AOB فريداً لضمان استمراريته بعد تحديثات اللعبة"
اليوم 3: العثور على خطاف RX	الدقيقة 6: "اعثر على OPcodes الحركة"
اليوم 4: توثيق البنية	الدقيقة 10: "أنشئ مفسّر Python لتحويل الهكس إلى نص عادي"
اليوم 5: تحديثات اللعبة، ابدأ من جديد	تم.

ذكاؤك الاصطناعي يستطيع الآن:

• قراءة أي ذاكرة فورياً (أعداد صحيحة، أعداد عشرية، نصوص، مؤشرات)
• تتبّع سلاسل المؤشرات: [[base+0x10]+0x20]+0x8 → تُحل في ميلي ثانية
• تحليل الهياكل تلقائياً مع أنواع الحقول وقيمها
• تحديد كائنات C++ عبر RTTI: "هذا كائن CPlayer"
• فك تجميع الدوال وتحليلها
• تصحيح الأخطاء بشكل غير مرئي باستخدام نقاط توقف للعتاد + مراقب افتراضي Ring -1
• والكثير غير ذلك!

---

كيف يعمل

flowchart TD
    AI[AI Agent: Claude/Cursor/Copilot]
    
    AI -->|MCP Protocol - JSON-RPC over stdio| MCP
    
    MCP[mcp_cheatengine.py - Python MCP Server]
    
    MCP <-->|Named Pipe - Async| PIPE
    
    PIPE["\\.\\pipe\\CE_MCP_Bridge_v99"]
    
    PIPE <--> CE
    
    subgraph CE[Cheat Engine - DBVM Mode]
        subgraph LUA[ce_mcp_bridge.lua]
            WORKER[Worker Thread - Blocking I/O]
            MAIN[Main Thread - GUI + CE API]
            WORKER <-->|Sync| MAIN
        end
    end
    
    MAIN -->|Memory Access| TARGET[Target .exe]

---

التثبيت

pip install -r MCP_Server/requirements.txt

أو يدوياً:

pip install mcp pywin32

[!NOTE] وضع الأنبوب الأصلي لنظام Windows فقط لأنه يستخدم الأنابيب المسماة (pywin32). استخدم نقل مرحّل TCP عندما يعمل خادم MCP خارج بيئة Windows التي تستضيف Cheat Engine ولا يمكنه فتح الأنبوب المسمى مباشرة.

---

البدء السريع

1. تحميل الجسر في Cheat Engine

1. فعّل DBVM في Cheat Engine إذا كنت تخطط لاستخدام أدوات DBVM.
2. افتح محرك Lua أو منفّذ السكربتات في Cheat Engine.
   • المفضل: File -> Execute Script -> افتح MCP_Server/ce_mcp_bridge.lua -> Execute.
   • إذا كان إصدار Cheat Engine لديك لا يعرض File -> Execute Script، استخدم Table -> Show Cheat Table Lua Script، والصق سطر dofile(...) أدناه، ونفّذه:

dofile([[C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_mcp_bridge.lua]])

ابحث عن: [MCP v12.0.0] MCP Server Listening on: CE_MCP_Bridge_v99

2. إعداد عميل MCP

أضف إلى إعداد MCP الخاص بك (مثال: mcp_config.json):

{
  "servers": {
    "cheatengine": {
      "command": "python",
      "args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"]
    }
  }
}

أعد تشغيل IDE لتحميل إعداد خادم MCP.

بالنسبة إلى Codex، أضف كتلة خادم TOML إلى ~/.codex/config.toml:

[mcp_servers.cheatengine]
command = "python"
args = ['C:\path\to\cheatengine-mcp-bridge\MCP_Server\mcp_cheatengine.py']

استخدم علامات الاقتباس المفردة لمسار Windows حتى يتعامل TOML مع الخطوط المائلة العكسية حرفياً.

نقل مرحّل TCP

يتيح مرحّل TCP لـ mcp_cheatengine.py التواصل مع Cheat Engine عبر مقبس TCP بدلاً من فتح الأنبوب المسمى لنظام Windows بنفسه. لا يزال Cheat Engine وجسر Lua يعملان على Windows، بينما يمكن لخادم MCP العمل في أي مكان يمكنه الوصول إلى المرحّل: عملية Windows أخرى، أو جهاز افتراضي (VM)، أو حاوية، أو مضيف Linux، أو جهاز بعيد. يمكن استخدام هذا أيضاً مع WSL دون تغيير جسر Lua.

1. على Windows، حمّل MCP_Server/ce_mcp_bridge.lua في Cheat Engine كالمعتاد.
2. على Windows، ابدأ المرحّل:

python C:\path\to\cheatengine-mcp-bridge\MCP_Server\ce_tcp_relay.py --host 127.0.0.1 --port 9876

3. في البيئة التي سيعمل فيها خادم MCP، ثبّت تبعية MCP بدون pywin32، ثم شغّل/اضبط خادم MCP باستخدام نقل TCP:

python3 -m pip install -r MCP_Server/requirements-tcp.txt

CE_MCP_TRANSPORT=tcp \
CE_MCP_HOST=127.0.0.1 \
CE_MCP_PORT=9876 \
python3 /path/to/cheatengine-mcp-bridge/MCP_Server/mcp_cheatengine.py

لإعدادات عملاء MCP التي تدعم متغيرات البيئة:

{
  "servers": {
    "cheatengine": {
      "command": "python3",
      "args": ["/path/to/cheatengine-mcp-bridge/MCP_Server/mcp_cheatengine.py"],
      "env": {
        "CE_MCP_TRANSPORT": "tcp",
        "CE_MCP_HOST": "127.0.0.1",
        "CE_MCP_PORT": "9876"
      }
    }
  }
}

اضبط --host على المرحّل وCE_MCP_HOST على خادم MCP على عناوين تتوافق مع إعداد شبكتك. أبقِ المرحّل مرتبطاً بالواجهات الموثوقة فقط، لأن أي شخص يمكنه الوصول إليه يمكنه التحكم في جسر Cheat Engine.

3. التحقق من الاتصال

استخدم أداة ping للتحقق من الاتصال:

{"success": true, "version": "12.0.0", "message": "CE MCP Bridge Active"}

4. ابدأ بطرح الأسئلة

"What process is attached?"
"Read 16 bytes at the base address"
"Disassemble the entry point"

---

~180 أداة من أدوات MCP متاحة

الذاكرة

الأداة	الوصف
read_memory, read_integer, read_string	قراءة أي نوع بيانات
read_pointer_chain	تتبّع مسارات [[base+0x10]+0x20]
scan_all, aob_scan	العثور على القيم وأنماط البايتات

التحليل

الأداة	الوصف
disassemble, analyze_function	تحليل الكود
dissect_structure	كشف الحقول والأنواع تلقائياً
get_rtti_classname	تحديد أنواع كائنات C++
find_references, find_call_references	المراجع المتبادلة

التصحيح

الأداة	الوصف
set_breakpoint, set_data_breakpoint	نقاط توقف للعتاد
start_dbvm_watch	تتبّع غير مرئي في Ring -1

دورة حياة العملية

الأداة	الوصف
open_process, get_process_list	الارتباط بالعمليات قيد التشغيل أو تعدادها
create_process	تشغيل عملية جديدة تحت سيطرة CE
pause_process, unpause_process	إيقاف / استئناف تنفيذ الهدف

تخصيص الذاكرة

الأداة	الوصف
allocate_memory, free_memory	حجز وتحرير الذاكرة في الهدف
set_memory_protection, full_access	ضبط علامات حماية الصفحات

حقن الكود

الأداة	الوصف
inject_dll	تحميل DLL في العملية الهدف
execute_code, execute_method	تشغيل shellcode أو أساليب CE Lua عن بُعد

إدارة الرموز

الأداة	الوصف
register_symbol, get_symbol_info	إنشاء الرموز المسماة والاستعلام عنها
enable_windows_symbols	تفعيل دقة رموز PDB