rea-toolkit

rea（Reverse Engineer Anything）MCP 生态的补丁执行层：补齐「分析 → 写回 → 验证」闭环。

基于 rea 6.8.0

本项目基于 rea（Reverse Engineer Anything，REA Agents） 6.8.0 版本修改而来，在其之上扩展了补丁执行层（rea_patcher / rea_text_patcher / rea_patch_server）。上游 rea 采用 MIT License，本项目同样以 MIT 协议开源。

为什么做这个

rea-agents 是目前最热门的逆向分析 MCP server（约 1.7 万星），提供 170+ 个只读分析工具：反编译、伪代码、字符串、引用、抓包、APK/固件拆解……原始文件字节永不被修改。

但逆向工作流最后一步往往是写回：改掉某个跳转、改配置、调参数。rea 本身不做这件事——这就是 rea-toolkit 的定位：

两层补丁能力，覆盖从 exe 到配置文件的全部写回场景：

• 二进制补丁 rea_patcher：PE 认知（VA/偏移换算）、hex 补丁、掩码通配、JSON 批量清单、dry-run 预览、回读校验、失败自动回滚。
• 多语言文本/代码补丁 rea_text_patcher：replace / regex / line / json / ini 五种操作原语，编码自适应（UTF-8/GBK/UTF-16），保留结构、注释与缩进，同样带备份回滚。

安装

pip install mcp
pip install rea-toolkit     # 或从源码: pip install .

CLI 快速开始

二进制补丁（rea-patcher）

# 查看 PE 概况（镜像基址 / 段表 / SHA-256）
rea-patcher info game.exe

# dump 文件偏移处字节
rea-patcher dump game.exe 0x434 16

# 打补丁：偏移:旧字节:新字节（可多次 -p；va0x 前缀自动按 image base 换算）
rea-patcher patch game.exe -p 0x434:7508EB02:90909090

# 掩码通配（? 任意字节）+ dry-run 预览
rea-patcher patch game.exe -p "0x100:75??EB??:9090E9??" --dry-run

# JSON 清单批量补丁（可复用、可交接）
rea-patcher patch game.exe --manifest patches.json

# 校验 / 恢复 / 哈希
rea-patcher verify game.exe 0x434 90909090
rea-patcher restore game.exe --force
rea-patcher sha256 game.exe

文本/代码补丁（rea-text-patcher）

# 只读查看（自动识别编码）
rea-text-patcher view app.py -s 1 -e 20

# 只读搜索定位
rea-text-patcher search main.py "hp_max" -r

# 打文本补丁（op 为 JSON，可多次 -o）：
rea-text-patcher patch app.py -o '{"op":"replace","old":"a","new":"b"}'
rea-text-patcher patch cfg.json -o '{"op":"json","path":"player.hp","new_value":9999}'
rea-text-patcher patch game.ini -o '{"op":"ini","section":"Graphics","key":"Width","new_value":2560}'

# 校验 / 恢复
rea-text-patcher verify app.py --contains "b"
rea-text-patcher restore app.py --force

文本补丁 ops 一览

安全网：所有 ops 顺序执行，任一失败整批拒绝；自动备份 <file>.reapat_txt_bak；dry-run 只预览；写回后回读校验，失败自动回滚。

MCP server（rea_patch_server）

作为 MCP server 接入任意支持 MCP 的 Agent（Claude Code / Codex / Cursor / Marvis 等），注册示例（stdio）：

command: python
args:    [<absolute path>\rea_patch_server.py]

二进制层工具

文本/代码层工具

所有偏移参数支持 0x 前缀十六进制字符串。

与同类项目对比

测试

python -m pytest tests/ -v

License

MIT