JinDaGe - reclass.net-mcp MCP Details

article

README

🚀 ReClass.NET MCP 集成

本项目为 ReClass.NET 提供了 MCP（模型上下文协议）集成，使 Claude Code 能够与 ReClass.NET 进行交互，以执行内存分析和逆向工程任务。

🚀 快速开始

本项目旨在为 ReClass.NET 提供 MCP 集成，让 Claude Code 可以与之交互，完成内存分析和逆向工程任务。

✨ 主要特性

1. ReClassMCP.Plugin (C#)

这是一个 ReClass.NET 插件，在 ReClass.NET 加载时会在端口 27015 启动一个 TCP 服务器。
通过 TCP 上的 JSON-RPC 公开 ReClass.NET 的功能。
处理内存读写、类/节点管理以及进程检查等操作。

2. ReClassMCP.Server (Python)

这是一个 MCP 服务器，通过 TCP 连接到 ReClass.NET 插件。
将 MCP 协议转换为插件命令。
为 Claude Code 提供可用的工具。

📦 安装指南

获取插件

选项 1：下载预构建版本（推荐）

从发布页面下载 ReClassMCP.zip。
解压并将 x64/ 或 x86/ 文件夹（需与你的 ReClass.NET 版本匹配）中的内容复制到 ReClass.NET 的 Plugins 文件夹。
MCP - Server/ 文件夹包含 Python MCP 服务器。

选项 2：从源代码构建

克隆本仓库和 ReClass.NET：

git clone https://github.com/NateWeav/ReClassMCP.git
cd ReClassMCP
git clone https://github.com/ReClassNET/ReClass.NET.git

在 Visual Studio 2019 及以上版本中打开解决方案，或运行 build.ps1。
将构建输出中的 ReClassMCP.dll 和 Newtonsoft.Json.dll 复制到 ReClass.NET 的 Plugins 文件夹。

安装 MCP 服务器

安装 Python 3.10 或更高版本。
安装 MCP 服务器依赖项：

cd ReClassMCP.Server
pip install -r requirements.txt

配置 Claude Code

将以下内容添加到你的 Claude Code MCP 配置文件（~/.claude/mcp.json 或项目 .claude/mcp.json）中：

{
  "mcpServers": {
    "reclass": {
      "command": "python",
      "args": ["/path/to/ReClassMCP/ReClassMCP.Server/reclass_mcp_server.py"],
      "env": {}
    }
  }
}

或者使用 uv：

{
  "mcpServers": {
    "reclass": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ReClassMCP/ReClassMCP.Server", "python", "reclass_mcp_server.py"],
      "env": {}
    }
  }
}

📚 详细文档

可用的 MCP 工具

连接与状态

| 工具 | 描述 | |------|-------------| | IsConnected | 检查 ReClass.NET 插件是否可用 | | GetStatus | 获取当前状态，包括已附加的进程信息 | | GetProcessInfo | 获取详细的进程信息 |

内存操作

| 工具 | 描述 | |------|-------------| | ReadMemory | 从已附加的进程中读取内存 | | WriteMemory | 向已附加的进程写入内存 | | ParseAddress | 解析地址公式（例如，module.exe+0x1234） |

模块与节信息

| 工具 | 描述 | |------|-------------| | GetModules | 列出进程中所有已加载的模块 | | GetSections | 列出所有内存节 |

类/结构管理

| 工具 | 描述 | |------|-------------| | GetClasses | 列出项目中的所有类 | | GetClass | 获取特定类的详细信息 | | GetNodes | 获取类中的所有节点/字段 | | CreateClass | 创建一个新的类/结构 | | AddNode | 向类中添加一个新字段 | | RenameNode | 重命名字段 | | SetComment | 设置字段的注释 | | ChangeNodeType | 更改字段的类型 |

支持的节点类型

数值类型：int8、int16、int32、int64、uint8、uint16、uint32、uint64、float、double
十六进制类型：hex8、hex16、hex32、hex64
文本类型：utf8text、utf16text、utf32text、utf8textptr、utf16textptr、utf32textptr
向量类型：vector2、vector3、vector4
矩阵类型：matrix3x3、matrix3x4、matrix4x4
其他类型：pointer、function、functionptr、virtualmethodtable、bool

💻 使用示例

配置完成后，你可以向 Claude Code 提出以下请求：

"连接到 ReClass.NET 并显示当前的类"

"读取地址 0x7FF12345 处的 64 字节内存"

"创建一个名为 'ConfigData' 的新类，并添加标志（uint32）和计数（int32）字段"

"分析地址 0x7FF12345 处的内存，并建议合适的字段类型"

📄 许可证

本项目采用 MIT 许可证。

reclass.net-mcp