Atengk Mcp Server Reverse

CI Release PyPI Docker Python 3.11+ License

mcp-server-reverse（PyPI 包名：atengk-mcp-server-reverse）是一款专为 AI Agent / LLM 打造的跨平台下一代二进制静态逆向分析、跨样本比对与纵深数字取证（DFIR）MCP Server。

采用**“纯 Python 静态分析内核（lief + capstone + pefile）+ 按需外部 CLI 增强适配层（radare2 / objdump / floss / yara）”混合分层架构：无需预装庞大的商业逆向套件，开箱即可对 PE（.exe/.dll/.sys）、ELF（Linux/Android .so）、Mach-O（macOS/iOS，含 Fat Binary 多架构切片） 执行全景静态画像、跨会话二阶差异对比（ADR-0008）、函数控制流图（CFG）抽取、写时复制（COW）内存虚拟打补丁与安全镜像导出、单字节异或（XOR）与 Base64 反混淆检索、滑动窗口局部高熵块探测、全平台漏洞缓解加固审计、YARA 规则匹配、PE Rich Header 编译器版本追溯、纯 Python SSDEEP 模糊哈希计算、Mach-O Entitlements 清单提取、多源无符号函数恢复（PE64 .pdata / PE32 序言扫描 / ELF .eh_frame）、ARM Thumb 模式自适应切换、函数级折叠交叉引用（Xref）定位、.NET CLR 托管程序与运行时版本自动分诊**（ADR-0007）以及非原生格式智能魔数嗅探（Format Sniffer）；当宿主机或容器环境存在外部工具时，自动解锁伪代码反编译与混淆栈字符串解码。

---

✨ 核心特性

• 100% 纯 Python 核心底座与 PE 双轨稳健解析：基于 lief、capstone、pefile 构建跨格式解析内核，针对非标或加壳的 32 位（PE32）与 64 位（PE32+）样本具备 pefile 双轨回退解析防御，零外部 CLI 依赖即可原生运行 21 个核心逆向分析与数字取证工具。
• 跨会话二阶结构化差异画像 (BinaryDiff)：提供 diff_sessions 一键对比两个样本的 SSDEEP 模糊哈希（0~100 相似度得分）、节区尺寸与香农熵差异（entropy_delta，高亮新增异常高熵节区）、导入导出敏感 API 增删集合与高危行为分类标签，并自动推导公共符号的代码段基址重定位偏移（ADR-0008）。
• 写时复制虚拟打补丁与防自毁安全物理导出：在分析会话内支持原子内存字节修改、分支反转 What-If 假设推演与 CFG 动态重绘；提供 export_patched_binary 将叠加补丁后的镜像安全落盘，强校验拦截同文件覆写自毁，在类 Unix 平台自动继承源文件执行权限位。
• 轻量单字节异或穷举与 Base64 反混淆检索：在 search_strings 中内置单字节 XOR（0x01~0xFF）穷举解密、指定密钥解密与标准 Base64 反混淆解码，无 key 盲扫结合正则精准捕获隐藏明文，并自动关联 IOC 威胁情报标签。
• 多源无符号内部函数恢复体系：针对 64 位 PE 自动解析 .pdata 异常目录恢复 sub_<va>（exception_frame）；针对 32 位 PE 扫描标准栈帧序言（55 8b ec/55 89 e5）恢复内部函数（prologue）；针对 Linux ELF 解析 .eh_frame DWARF 展开表恢复内部非叶函数（eh_frame）。
• ARM Thumb 模式自适应对齐与反汇编切换：在 disassemble 与 convert_address 中自动识别 ARM 奇数目标地址，2 字节对齐并自适应切换 Capstone Thumb 模式，支持显式 thumb=True 强制模式控制，彻底解决 ARM32 共享库反汇编乱码问题。
• 交叉引用函数级折叠归集与注释缓存加速：find_xrefs 支持 group_by="function" 维度，将高频 API 交叉引用按调用方函数归集折叠（含引用频次倒序与未识别节区归集），成倍节约 Agent Token 预算；底层反汇编内联注释建立会话级生命周期缓存，补丁变更时自动失效刷新。
• .NET CLR 托管程序自动分诊与 CIL 引导：自动检测 PE 数据目录项 IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR，通过 ECMA-335 BSJB 根元数据解析提取精准的目标运行时版本（如 v4.0.30319），并为 AI Agent 注入专用 CIL 反编译引导（ILSpy / dnSpy），终结在原生汇编引导桩上的盲目试错（ADR-0007）。
• 未支持格式智能魔数嗅探 (Format Sniffer)：针对 Adobe Flash (SWF)、Android (DEX/APK)、WebAssembly (WASM)、网络流量归档 (HAR) 与底层抓包文件 (PCAP/PCAPNG)，在安全边界层自动通过特征魔数识别并返回结构化工具链重定向建议，赋能 Agent 智能自纠偏。
• 面向 Agent 的自然语言参数别名自愈容错：在核心逆向工具中深度集成 Pydantic AliasChoices，原生容错 session_a/source、destination/output_path、query/pattern、thumb/is_thumb 等大模型参数命名幻觉，赋予 Agent 零样本（Zero-Shot）工具调用的极佳鲁棒性。
• 函数控制流图 (CFG) 与 Mermaid 可视化：自动切分单入口单出口基本块（BasicBlock），计算条件跳转、循环回跳边与圈复杂度，并直接输出紧凑规范的 Mermaid flowchart TD 流程图文本供 Agent 直观阅读与拓扑推演。
• 全平台漏洞缓解机制跨架构画像与安全评分：深度审计 Windows（DEP/ASLR/SafeSEH/CFG/CET）、Linux（NX/PIE/RELRO/Canary/FORTIFY）与 macOS（PIE/代码签名/Hardened Runtime），输出加权安全评分（0~100）与利用难度量化评级。
• 节区滑动窗口局部异常高熵块细粒度探测：突破全局香农熵容易被大节区稀释的瓶颈，以 2KB~4KB 滑动窗口敏锐捕捉代码段或只读数据段中偷渡的微型加密 Shellcode 与加壳 Payload。
• 纵深数字取证同源指纹增强：自动解析 PE Rich Header 提取 Visual Studio 编译器工具链组件（ProdID/BuildNumber/引用计数）；基于纯 Python 滚动哈希计算标准 SSDEEP 模糊哈希（CTPH）；深度反序列化 Mach-O 代码签名 SuperBlob 提取 Entitlements XML 权限清单。
• 独立 YARA 规则匹配与优雅降级：支持文本规则即时编译与规则文件路径加载，自动映射命中特征字符串的文件物理偏移与虚拟内存地址（VA）；未安装 yara-python 时提供结构化引导与平滑降级。
• 指令级 RIP/PC-relative 交叉引用引擎：自动扫描 x86_64 RIP-relative、ARM64 4 指令滑动窗口 ADRP + ADD/LDR、直接分支及数据段全局指针，首次查询后台线程惰性构建倒排索引并缓存，同会话后续查询毫秒级 $O(1)$ 命中。
• 四级跨平台外部工具寻址：按 CLI 参数 > MCP_REVERSE_* 环境变量 > 系统 PATH > 操作系统常见安装目录 自动探测 radare2/rizin、llvm-objdump/objdump 与 floss，提供结构化降级指引。
• LRU 会话池与上下文防爆：以文件内容哈希（Fat Binary 结合架构生成复合摘要）前 12 位作为 session_id 驻留内存（默认最多 8 个会话），所有检索工具强制分页与紧凑单行格式化输出。

---

🧰 23 个正交 MCP Tools 矩阵

业务分组	Tool 名称	核心职责与关键能力说明
1. 会话与全景画像 (Triage & Session)	open_binary	校验沙箱并加载二进制至 LRU 缓存，集成 Format Sniffer 智能魔数嗅探拦截与工具链重定向；自动识别 .NET CLR 托管程序（is_managed、clr_runtime_version 与 clr_guidance 转向建议）；返回哈希（含 Imphash/SSDEEP）、防护标志、高熵加壳预警及深度取证画像（TLS 回调、PDB/Rich Header 编译器指纹、Overlay 附加数据、代码签名与 Mach-O Entitlements 清单）
	list_sessions	列出当前内存中驻留的所有二进制分析会话元数据摘要与时间戳
	close_session	显式释放指定 session_id 或一键清空全部缓存会话以回收系统内存
2. 结构与符号检视 (Structure & Symbols)	get_sections	获取所有节区/段分布、权限、全局香农熵（0.0~8.0），支持 name_filter 正则过滤，可选开启 detect_local_entropy 滑动窗口精准探测局部高熵隐蔽块
	get_imports	分页检索导入表，支持按库名、函数名正则与 8 类敏感行为标签（crypto、process_injection、anti_debug 等）过滤
	get_exports	分页检索导出函数表、序号（Ordinal）、虚拟地址与转发器（Forwarder）
	get_symbols	分页检索符号表；支持多源无符号内部函数恢复：64 位 PE 解析 .pdata（exception_frame）、32 位 PE 序言特征扫描（prologue）与 Linux ELF 解析 .eh_frame 展开表（eh_frame）
3. 字符串与特征扫描 (Strings & Signatures)	search_strings	提取 ASCII / UTF-16LE 字符串，内置 7 类 IOC 威胁情报自动标记；原生支持单字节 XOR 穷举解密（xor_bruteforce=True）、指定密钥解密（xor_key）与 Base64 反混淆检索（deobfuscate_base64=True），可选 use_floss 软降级解码栈字符串
	search_bytes_and_constants	支持类 IDA 十六进制通配符搜索（如 "48 89 5C 24 ? 57"）及内置密码学魔数常量（AES S-Box/Rcon、SHA/MD5 IV、CRC32、DES）扫描
	scan_yara	传入规则文本或规则文件对会话内存或文件执行 YARA 匹配，返回命中规则元数据与特征字符串的文件偏移及虚拟内存地址（VA）
4. 反汇编、交叉引用与控制流 (Disasm, Xrefs & CFG)	disassemble	多架构静态反汇编（支持 stop_at_ret 截断），自动内联相对寻址字符串与符号注释；支持 ARM Thumb 模式自适应切换与 thumb=True 显式控制，底层接入会话级注释只读缓存加速
	find_xrefs	惰性构建会话级倒排索引，检索指向目标虚拟地址或符号的全部代码与数据交叉引用；支持 group_by="function" 按调用方函数归集折叠（含引用数排序与 unresolved_<sec> 节区归纳）
	read_memory	按 VA、RVA 或文件物理偏移读取原始字节（单次上限 1024 字节），输出连续十六进制与标准 16 字节宽度 Hexdump + ASCII 对照视图
	convert_address	在虚拟地址（VA）、相对虚拟地址（RVA）与文件物理偏移（Offset）之间双向精确换算并定位所属节区与权限；支持 ARM 奇数地址自动对齐与 Thumb 模式标记
	analyze_cfg	分析函数单入口单出口基本块（BasicBlock）、分支跳转关系与圈复杂度，并直接输出 Mermaid flowchart TD 控制流流程图文本
5. 内存虚拟补丁套件 (Virtual Patching)	patch_memory	在写时复制（COW）虚拟层应用十六进制内存补丁，物理文件 100% 只读保真，即时影响后续反汇编、字符串提取与控制流分析
	list_patches	清晰列出当前会话中所有已激活的内存虚拟补丁记录、目标地址与原始/修改字节对比
	revert_patch	指定 patch_id 单项撤销补丁，或缺省一键回滚当前会话全部补丁恢复初始净室内存镜像
	export_patched_binary	穿透写时复制覆写层，将叠加全部激活补丁后的完整二进制镜像安全导出至沙箱白名单磁盘路径，严格拦截同文件覆写自毁并继承 Unix 文件执行权限
6. 安全加固与外部增强 (Mitigations & Capabilities)	audit_mitigations	系统化审计目标二进制的跨平台漏洞利用缓解措施，输出 0~100 安全评分与利用难度评级（Low/Medium/High/Extreme）
	decompile_function	受控异步调用本地 radare2/rizin 生成目标函数的类 C 伪代码；未安装时返回结构化安装指引与软降级建议
	get_capabilities	返回核心引擎版本、安全沙箱边界配置及四级寻址器探测到的外部 CLI 工具可用状态
7. 跨样本差异与同源画像 (Diff & Comparison)	diff_sessions	跨会话对比两个活跃分析会话的二阶结构化差异画像，计算 0~100 SSDEEP 模糊哈希同源相似度分值，输出节区尺寸与香农熵差异（entropy_delta）、敏感导入导出 API 增删集合与高危行为分类标签，并自动推导公共符号的代码段基址重定位偏移（ADR-0008）

🤖 Agent 鲁棒性与参数别名映射 (Parameter Aliasing)

在由 LLM / AI Agent 驱动的自主逆向分析编排中，大模型常因自然语言提示的微小差异产生参数名同义词幻觉（例如习惯性传入 query 而非 pattern，或传入 address 而非 target）。本服务端基于 Pydantic AliasChoices 实现了零样本调用的自愈容错机制，原生兼容以下参数别名：

MCP Tool	标准参数名	支持的参数别名 (Validation Aliases)	典型应用与防幻觉场景
diff_sessions	session_id_a	session_a, source, source_session	兼容模型以 session_a 或 source 传入基准会话 ID
diff_sessions	session_id_b	session_b, target, target_session	兼容模型以 session_b 或 target 传入比对目标会话 ID
export_patched_binary	output_path	output_file, target_path, destination	兼容模型以 output_file 或 destination 传入目标文件导出路径
search_strings	pattern	filter, query, keyword, search	兼容模型以 query: "password" 或 keyword: "http" 检索字符串
search_strings	xor_key	key	兼容模型以 key: 0x5A 传入单字节解密密钥
search_strings	xor_bruteforce	bruteforce, brute_force	兼容模型以 bruteforce: true 开启 XOR 穷举盲扫
search_strings	deobfuscate_base64	base64, b64	兼容模型以 base64: true 开启 Base64 编码反混淆解码
search_bytes_and_constants	hex_pattern	pattern, filter, query, keyword, search	兼容模型以 pattern: "48 89 5C" 检索十六进制特征
get_sections	name_filter	name, filter, query, pattern	兼容模型以 name: ".text" 或 filter: ".rsrc" 检索指定节区
get_imports	name_filter	name, filter, query, pattern	兼容模型以 query: "VirtualAlloc" 检索目标 API
get_exports	name_filter	name, filter, query, pattern	兼容模型以 name: "CreateProcess" 筛选导出符号
get_symbols	name_filter	name, filter, query, pattern	兼容模型以 query: "main" 检索符号表
convert_address	address	target, va, offset, location	兼容模型以 target: "0x140001000" 传入待转换地址
convert_address	thumb	thumb_mode, is_thumb	兼容模型以 thumb_mode: true 显式控制 ARM Thumb 模式
read_memory	address	target, va, offset, location	兼容模型以 target 或 va 指定内存读取基准地址
disassemble	target	location, address, va, entry	兼容模型以 address 或 entry 指定反汇编入口
disassemble	thumb	thumb_mode, is_thumb	兼容模型以 thumb_mode: true 显式指定 ARM Thumb 模式反汇编
find_xrefs	target	location, address, va, entry	兼容模型以 address 或 location 指定被引用目标
find_xrefs	group_by	group, mode	兼容模型以 group: "function" 开启函数级聚合折叠
analyze_cfg	target	location, address, va, entry	兼容模型以 entry 或 address 指定函数控制流分析入口
decompile_function	target	location, address, va, entry	兼容模型以 address 或 entry 指定伪代码反编译函数

---

🚀 快速开始

1. 使用 uvx 一键启动（推荐）

# 自检运行环境与可选外部逆向工具状态
uvx atengk-mcp-server-reverse --doctor

# 以默认 stdio 模式启动并限制允许分析的样本目录
uvx atengk-mcp-server-reverse --allowed-dir /path/to/samples --allowed-dir /path/to/output

2. 通用 MCP 服务配置 (mcpServers)

在任意支持 MCP 标准协议的宿主配置文件中添加以下通用配置：

{
  "mcpServers": {
    "reverse": {
      "command": "uvx",
      "args": [
        "atengk-mcp-server-reverse",
        "--allowed-dir",
        "D:/samples",
        "--allowed-dir",
        "D:/output"
      ],
      "env": {
        "MCP_REVERSE_MAX_FILE_SIZE_MB": "100",
        "MCP_REVERSE_LOG_LEVEL": "INFO"
      }
    }
  }
}

3. Docker 容器化隔离部署（内置 radare2 + objdump）

docker run -d \
  --name mcp-reverse \
  -p 8000:8000 \
  -v /path/to/samples:/samples:ro \
  -v /path/to/output:/output:rw \
  -e MCP_REVERSE_ALLOWED_DIRS="/samples,/output" \
  -e MCP_REVERSE_AUTH_TOKEN=YOUR_API_TOKEN \
  ghcr.io/atengk/mcp-server-reverse:latest

提示：建议将样本目录以只读方式（:ro）挂载以确保数字取证第一现场绝对防篡改；若需使用 export_patched_binary 导出打完补丁的二进制镜像，请单独挂载可写输出目录（:rw）。

---

💡 常用使用提示词 (Prompt Examples)

挂载本 MCP 服务后，可直接复制以下 15 个工业级实战提示词驱动 AI 执行专业逆向分析、漏洞研判与数字取证：

场景 1：二进制全景画像与深度取证初筛 (Triage & DFIR)

“请对 D:/samples/suspicious.exe 执行静态逆向初筛：

1. 获取它的 MD5/SHA256/Imphash、SSDEEP 模糊哈希、编译时间戳、PDB 路径、PE Rich Header 工具链编译器指纹、TLS 回调以及是否存在尾部 Overlay 附加数据；
2. 列出所有命中 process_injection、anti_debug、network 与 execution 类别的敏感导入 API；
3. 提取所有归类为 url、ipv4、registry 和 suspicious_cmd 的 IOC 字符串，给出综合威胁研判结论。”

场景 2：函数控制流图抽取与 Mermaid 流程图可视化 (CFG Analysis)

“目标函数 sub_140001000 包含复杂的条件跳转与混淆分支：

1. 请调用 analyze_cfg 对该函数进行控制流分析，提取基本块边界、分支跳转走向与圈复杂度；
2. 直接渲染输出该函数的 Mermaid flowchart TD 流程图，指出哪一条分支是校验失败跳转，哪一条分支通向关键解密载荷；
3. 给出该函数的精简逻辑审计报告与圈复杂度风险评级。”

场景 3：写时复制 (COW) 内存虚拟补丁与分支反转 What-If 推演 (Virtual Patching)

“在当前分析会话中验证绕过反调试的可能性：

1. 对 0x140001050 处的条件跳转指令（74 12 即 JZ）调用 patch_memory，虚拟替换为 75 12（JNZ）或 90 90（NOP）；
2. 重新调用 disassemble 和 analyze_cfg，观察补丁应用后指令流与控制流图的实时演变，确认是否已绕过校验；
3. 完成验证后调用 list_patches 核对补丁记录，并调用 revert_patch 撤销补丁恢复原始净室镜像（全程物理样本保持零磁盘改动）。”

场景 4：全平台漏洞缓解机制加固审计与评分 (Mitigations Audit)

“请针对 D:/samples/target_service.elf 执行漏洞利用防护审计：

1. 调用 audit_mitigations 检查 NX、PIE、RELRO、Stack Canary 与 FORTIFY 编译项开启状态；
2. 评估该二进制的加固安全评分与利用难度评级（Low/Medium/High/Extreme），并针对未开启的防护项提出具体加固建议；
3. 输出格式化的安全加固审计报告供开发团队闭环加固。”

场景 5：节区滑动窗口局部异常高熵块隐蔽探测 (Local Entropy Detection)

“样本 .text 代码段整体香农熵仅为 5.8，疑似内部偷渡了微型加壳代码：

1. 调用 get_sections 并开启 detect_local_entropy=True（窗口 2048 字节、步长 1024 字节）；
2. 检查返回的 local_high_entropy_blocks 列表，定位局部熵值超过 7.2 的连续异常区间起始偏移与虚拟地址；
3. 使用 read_memory 检视该高熵区间的 Hexdump 数据，判断其为加密 Shellcode 还是压缩配置。”

场景 6：工业级 YARA 特征规则即时扫描 (YARA Scanning)

“安全团队下发了针对某 APT 恶意木马家族的 YARA 规则，请协助在会话中排查：

1. 调用 scan_yara 并传入规则文本字符串，扫描当前二进制会话的内存镜像；
2. 若命中规则，列出所有匹配的特征字符串标识、物理文件偏移与虚拟内存地址（VA）；
3. 使用 find_xrefs 追踪是哪些函数代码引用了命中的恶意特征字符串，评估受感染影响面。”

场景 7：关键字符串交叉引用追踪与控制流还原 (String Xrefs -> Disassembly)

“在当前分析会话中：

1. 搜索包含 http、token 或 Error 关键字的字符串并记录其虚拟地址；
2. 使用 find_xrefs 查找是哪些代码指令引用了这些字符串；
3. 对发起引用的函数起始地址执行 disassemble，结合内联注释还原该函数的核心调用逻辑（若本机已安装 radare2，请同时调用 decompile_function 输出伪代码对照）。”

场景 8：去符号 (Stripped) 64 位 PE 内部函数恢复与密码学算法识别

“目标文件 D:/samples/stripped_payload.dll 已被剥离符号表，请协助定位其加密逻辑：

1. 调用 search_bytes_and_constants 并开启 scan_crypto=True，检查二进制中是否包含 AES、SHA-256、MD5 或 CRC32 的特征魔数常量表；
2. 使用 find_xrefs 定位引用了该密码学常量表的代码地址；
3. 调用 get_symbols(symbol_type="exception_frame") 查看通过 .pdata 异常目录恢复出的 sub_<va> 内部函数列表，定位所属函数并反汇编分析其加密流程。”

场景 9：.NET CLR 托管程序自动分诊与反编译转译引导 (.NET Assembly Triage)

“请对 D:/samples/client_payload.exe 进行初筛分诊：

1. 调用 open_binary 检查该文件是否为 .NET 托管程序（检查返回的 is_managed 与 runtime 字段）；
2. 若 is_managed=true，读取并汇报其目标 CLR 运行时版本（如 clr_runtime_version: "v4.0.30319"）与 clr_guidance 行动建议；
3. 解释为何不建议在此类文件上直接调用原生机器码反汇编（disassemble），并推荐合适的 CIL 反编译器（如 ILSpy、dnSpy 或 python-net-decompiler）以还原高质量 C# 源码。”

场景 10：未支持文件魔数嗅探与外部专业工具链智能导流 (Format Sniffer Redirection)

“安全分析中捕获到一个未知文件 D:/samples/unknown_asset.dat，请尝试加载并研判：

1. 调用 open_binary 打开该文件；
2. 若返回 UNSUPPORTED_FORMAT 错误，检查 FormatSniffer 识别出的实际格式分类（如 Adobe Flash SWF、Android APK/DEX、WebAssembly WASM、HAR 流量归档或 PCAP 底层抓包）；
3. 根据响应中的 guidance 转向建议，告知对应的下一棒分析工具（如使用 jadx 分析 DEX，使用 traffic-inspector MCP 分析 HAR/PCAP，或使用 FFDec 分析 SWF），避免 Agent 陷入在非机器码文件上的盲目试错。”

场景 11：内存虚拟补丁持久化安全导出与权限位继承 (Export Patched Binary)

“我们已在当前会话中通过 patch_memory 成功修复了软件漏洞或规避了反调试逻辑：

1. 调用 list_patches 核对当前激活的全部内存虚拟补丁清单及覆写字节；
2. 调用 export_patched_binary 并指定 output_path="D:/output/cracked_binary.exe"，将修补后的镜像安全导出到独立输出目录（验证原样本文件未受破坏）；
3. 确认导出结果包含 exported_size、patch_count 与继承的执行权限位，为后续动态沙箱分析提供完整可执行载荷。”

场景 12：可疑数据段单字节 XOR 穷举与 Base64 反混淆检索 (Deobfuscated Strings Scanning)

“目标恶意样本数据段疑似存在加密混淆的 C2 域名与控制指令：

1. 调用 search_strings 并开启 xor_bruteforce=True 与 pattern="https?://"，对全镜像执行 0x01~0xFF 单字节异或穷举检索；
2. 同时开启 deobfuscate_base64=True，解码可能经过 Base64 编码的敏感配置；
3. 检视返回的 deobfuscated_strings 列表，提取命中的明文内容、所用密钥（xor_key）、虚拟地址与 IOC 威胁情报分类，还原真实的远程外联网络资产。”

场景 13：剥离符号 ARM Thumb 模式反汇编与 Linux ELF .eh_frame / PE32 序言恢复

“面对剥离了符号表的 ARM 共享库与 32 位二进制，请协助定位函数边界与反汇编：

1. 调用 get_symbols：对 Linux ELF 自动通过 .eh_frame DWARF 展开表恢复内部非叶函数（eh_frame），对 32 位 PE 自动通过栈帧序言特征扫描恢复内部函数（prologue）；
2. 针对 ARM 目标函数指针（如奇数地址 0x10001），调用 convert_address 验证其自动 2 字节对齐并切换为 Thumb 模式；
3. 调用 disassemble（传入 target="0x10001" 或显式指定 thumb=True），以标准 Thumb 紧凑指令模式反汇编，消除误按 ARM 模式反汇编产生的乱码。”

场景 14：1-Day 漏洞补丁与木马变种跨会话二阶结构化差异画像 (Cross-Session Binary Diff)

“我们捕获了同一恶意木马家族的原版样本与最新变种，需分析其演进机制：

1. 分别调用 open_binary 打开原版样本与变种样本，获取各自的 session_id；
2. 调用 diff_sessions(session_a=sid_orig, session_b=sid_mod) 执行跨会话二阶结构化比对；
3. 查看输出的 SSDEEP 模糊哈希同源相似度分值（0~100）、各个节区的香农熵变动量（entropy_delta，定位新注入的加壳高熵节区）、新增与删除的敏感导入 API 集合（高危注入与反调试标签），以及公共符号推导出的代码段基址重定位偏移。”

场景 15：高频系统 API 交叉引用函数级折叠归集与 Token 防爆 (Folded Function Xrefs)

“目标程序中 VirtualProtect 和 RegOpenKeyExA 被大量代码高频引用，扁平列表极易耗尽 LLM 上下文：

1. 调用 find_xrefs，指定 target="VirtualProtect" 并传入 group_by="function"；
2. 查看折叠归集后的调用函数列表（按各函数的引用计数倒序排列），直接获取发起调用的所属函数名、虚拟地址与具体引用条数；
3. 针对引用频次最高的可疑调用方函数，定向调用 disassemble 或 analyze_cfg 进行聚焦分析，大幅减少冗余指令与 Token 预算消耗。”

---

⚙️ CLI 参数与环境变量对照表

配置优先级：CLI 显式参数 > MCP_REVERSE_* 环境变量 > 内置默认值。

CLI 参数选项	对应环境变量	默认值	说明
-h, --help	-	-	输出完整中文帮助说明与示例并退出
-v, --version	-	-	输出版本号与核心引擎版本信息并退出
--check / --doctor	-	False	执行运行环境与四级外部工具寻址分级自检探针
-t, --transport	MCP_REVERSE_TRANSPORT	stdio	传输协议：stdio、sse、streamable-http
--host	MCP_REVERSE_HOST	127.0.0.1	sse / streamable-http 监听地址
-p, --port	MCP_REVERSE_PORT	8000	sse / streamable-http 监听端口
--allowed-dir	MCP_REVERSE_ALLOWED_DIRS	不限制	允许加载与导出二进制文件的根目录白名单（支持多次指定）
--max-file-size-mb	MCP_REVERSE_MAX_FILE_SIZE_MB	100	单文件最大允许体积（MB），超出立即熔断
--max-sessions	MCP_REVERSE_MAX_SESSIONS	8	进程内 LRU 会话池最大驻留数量
--auth-token	MCP_REVERSE_AUTH_TOKEN	None	远程 HTTP/SSE 模式可选 Bearer 鉴权令牌
--r2-path	MCP_REVERSE_R2_PATH	自动四级寻址	显式指定 radare2 / rizin 可执行文件路径
--objdump-path	MCP_REVERSE_OBJDUMP_PATH	自动四级寻址	显式指定 llvm-objdump / objdump 可执行文件路径
--floss-path	MCP_REVERSE_FLOSS_PATH	自动四级寻址	显式指定 floss 可执行文件路径
--log-level	MCP_REVERSE_LOG_LEVEL	INFO	日志级别（DEBUG、INFO、WARNING、ERROR）

---

🛠️ 本地开发与工程验证

# 1. 创建 Python 3.12 虚拟环境并同步依赖
uv venv --python 3.12
uv sync

# 2. 运行完整自动化测试套件 (136 个测试项全量通过)
uv run pytest

# 3. 运行代码规范与格式静态扫描
uv run ruff check src tests
uv run ruff format --check src tests

---

📄 开源许可证

本项目基于 Apache License 2.0 协议开源。