使用说明内容（Markdown格式）

Cheat Engine MCP Bridge 使用指南

• 项目简介

  • 这是一个基于 MCP（Model Context Protocol）的服务器实现，旨在把 Cheat Engine 与大语言模型(LLM) 客户端连接起来，通过标准化的 JSON-RPC 方式提供内存访问、工具执行和提示管理等功能，便于 LLM 客户端在本地环境中获取上下文信息并调用外部能力。

• 主要功能点

  • 通过 MCP 协议提供工具集：内存读取、指针展开、扫描、分析、反汇编、断点等多种实用工具。
  • 与 Cheat Engine 的本地桥接：通过本地进程/命名管道实现与 Cheat Engine 的通信，获取或操作目标进程内存。
  • 提供 JSON-RPC 接口：LLM 客户端通过 JSON-RPC 调用服务器暴露的工具，服务器返回结构化结果。
  • 可扩展的工具集合：包括内存读写、符号解析、结构解析、DBVM 相关功能、以及高层分析工具等。
  • Windows 专用实现细节：使用 pywin32 进行本地管道通信，确保在桌面环境中与 Cheat Engine 直接交互。

• 安装步骤

  • 确保系统为 Windows，Python 3.10 及以上。
  • 安装依赖：在仓库中运行以下命令安装所需包
    • 通过要求文件安装：pip install -r MCP_Server/requirements.txt
    • 或手动安装：pip install mcp pywin32
  • 运行服务器脚本：
    • 直接执行：python MCP_Server/mcp_cheatengine.py
  • 配置 Cheat Engine 的桥接组件（如 README 所示步骤），以在 Cheat Engine 端建立与 MCP 服务器的连接。

• 服务器配置（MCP 客户端需要的配置信息，示例为 JSON 表示，解释性描述）

  • 配置示例（JSON 结构，供 MCP 客户端读取，非代码块呈现）: { "servers": { "cheatengine": { "command": "python", "args": ["C:/path/to/MCP_Server/mcp_cheatengine.py"] } } }
  • 字段说明：
    • servers: 包含一个或多个 MCP 服务器配置的顶层对象。
    • cheatengine: 服务器的名称标识。
    • command: 启动服务器所使用的命令（例如 python）。
    • args: 启动命令的参数，指向具体的服务器脚本路径。
  • 说明：以上配置信息用于 MCP 客户端在需要时启动并连接到该 MCP 服务器。客户端本身不需要这段配置的具体实现代码，只需要知道服务器的标识、启动命令及参数即可。

• 基本使用方法

  • 启动后，MCP 客户端可以通过 JSON-RPC 调用 cheatengine 服务器暴露的工具，例如内存读取、扫描、分析等。
  • 客户端发送请求后服务器返回结构化的 JSON 响应，包含数据、状态以及错误信息（如有）。
  • 典型工作流程包括：测试连通性（ping）、读取内存、进行简单分析、以及调用辅助工具进行更复杂的操作。
  • 注意事项：在使用过程中请遵循 Cheat Engine 的安全与合规规范，避免对目标程序造成不可逆损害。