Cheat Engine MCP 服务器

使用说明

  • 项目简介
    • 这是一个基于 MCP(Model Context Protocol)设计的后端服务器实现,结合 Cheat Engine 的能力,向 LLM 客户端提供统一的 Resources、Tools、Prompts 等上下文服务,便于通过 API 调用实现对进程、内存、调试、Lua 脚本等的操作和查询。
  • 主要功能点
    • MCP 服务端实现:处理 MCP 请求与响应,提供标准化的 JSON-RPC 风格通信和通知机制。
    • 资源与工具管理:集中暴露 Cheat Engine 的资源、工具以及导出字段等能力,支持资源读取、工具调用、以及语言模型模板的渲染。
    • 脚本和运行时支持:内置 Lua、结构、记忆/指针等运行时,支持 Lua 调用、结构定义与读取、内存读取/写入等。
    • 会话与拓展性:会话管理、能力声明,以及对不同传输协议(如 stdio、SSE、WebSocket 等)的框架化支持。
  • 安装与运行步骤
    • 构建原生组件与后端:需要按仓库中的说明构建本地原生桥接与 Cheat Engine 相关组件(包括本地插件、核心后端等)。
    • 运行 MCP 服务器后端:
      • 通过 Python 启动后端服务(ce_mcp_server)作为 MCP 服务端。
      • 或使用打包的 npx 启动方式,结合 Codex/相关客户端进行注册。
    • 启动 Cheat Engine 插件/桥接:将 Cheat Engine 插件加载到 Cheat Engine 中,通过 MCP 后端提供的上下文进行互动。
    • 测试与验证:可使用仓库中的 live-runner 工具和示例工具,验证资源、工具、以及Lua等的调用。
  • 服务器配置(MCP 客户端需要的启动信息,示例以 JSON 形式呈现;注意这里列出的配置是 MCP 客户端需要用到的连接信息,实际端对端会在客户端配置中使用)
    • server_name: cheat-engine
    • command: "C:\Path\To\Python\python.exe" // 若使用 Python Backend
    • args: ["-m", "ce_mcp_server"] // 启动参数,使用默认 MCP 端口 5556
    • 备注: 也可使用 Node/NPX 启动方式,按 README 中的指引进行注册,例如通过 Codex 的 npx 入口注册 cheat-engine 服务。
    • 说明示例(JSON 形式,非代码块): { "server_name": "cheat-engine", "command": "C:\Path\To\Python\python.exe", "args": ["-m", "ce_mcp_server"], "startup_timeout_sec": 120 }
  • 基本使用方法
    • 注册与连接
      • 使用 MCP 客户端(如 Codex 的 MCP 客户端插件)将 Cheat Engine MCP 服务注册为一个服务器实例,使用上面的启动命令与参数进行连接。
    • 调用工具与读取资源
      • 通过工具名称(如 ce.list_tools、ce.read_memory、ce.aob_scan、ce.lua_eval 等)发起请求,服务器将返回标准化的 JSON 响应,包含结果、错误信息、以及必要的上下文数据。
    • 会话管理
      • 通过 ce.list_sessions、ce.get_attached_process 等工具查看当前连接和目标进程信息,必要时切换会话。
    • 调试与扩展
      • 借助内置的调试运行时和结构/Dissect 等运行时,结合 Cheat Engine 的 Lua 脚本能力进行自定义交互和数据获取。

服务器信息