项目简介

这是一个基于Python实现的MCP（Model Context Protocol）服务器，作为连接AI语言模型（如ChatGPT）与CheatEngine的桥梁。它使得AI客户端能够通过标准化的MCP接口，远程调用CheatEngine的功能，如读取指定进程的内存数据、分析汇编代码等。

主要功能点

• 连接管理: 自动连接并维护与CheatEngine的Socket通信。
• 内存读取: 根据AI指令，读取指定内存地址、指定数据类型的值，支持获取原始字节、汇编代码、操作码、地址注释等高级选项。
• 汇编分析: 提供内存地址对应的汇编代码信息。
• 连接状态检测: 检查与CheatEngine的连接是否正常。

安装步骤

1. 确保您的系统已安装Python环境。
2. 克隆本项目仓库到本地。
3. 在项目根目录下打开终端或命令行工具。
4. 安装所需的Python依赖库：

   pip install -r requirements.txt
   

5. 重要: 下载并安装项目指定的 CheatEngine插件。此插件是MCP服务器与CheatEngine通信的基础，若未安装，服务器将无法正常工作。请按照插件仓库的说明进行安装。

服务器配置 (供MCP客户端使用)

这是一个MCP服务器端程序，不是直接面向用户界面的应用。它需要由兼容MCP协议的客户端（如特定的AI应用前端）启动和管理。

配置MCP客户端以连接到此服务器时，通常需要提供以下信息：

• 服务器名称: 用于客户端显示和识别此服务器，推荐使用 'CheatEngine专家' (与服务器代码中定义一致)。
• 启动命令 (Command): 启动此Python脚本的命令，通常是 'python'。
• 启动参数 (Args): 传递给启动命令的参数，即主程序文件路径，通常是 '["main.py"]'。

例如，在支持MCP配置的JSON文件中，可能需要类似以下的逻辑配置片段（具体格式取决于客户端实现，此处为概念说明，请勿直接复制为代码）：

{
  "server_name": "CheatEngine专家",
  "command": "python",
  "args": ["main.py"],
  // 其他可选配置，如协议类型 (默认通常是 stdio) 等
}

客户端根据这些信息启动此Python程序，并通过标准输入/输出或配置的协议与服务器进行MCP协议通信。

基本使用方法

本服务器的功能主要通过其注册的“工具”（Tools）暴露给AI客户端。用户通过与MCP客户端（例如一个支持工具调用的AI聊天界面）交互，AI根据用户的指令判断需要调用哪个工具，并将相应的参数通过MCP协议发送给本服务器。

用户无需直接与此脚本交互，而是通过AI客户端间接使用以下主要工具：

• 'ce_connect': 用于检查与CheatEngine的连接状态。
• 'memory_read': 用于读取指定内存地址、指定数据类型的数据，AI会根据用户的请求提供地址、类型和可选的高级参数。
• 'test_echo': 一个简单的测试工具，用于回显AI发送的任何输入。

AI客户端会根据工具的描述和参数说明，向用户询问必要的信息来构建工具调用请求。