用ida-mcp-rs让AI反编译出C伪代码:decompile工具与Hex-Rays本地变量实战指南

原创2026-10-24 09:00:092,330 阅读

用ida-mcp-rs让AI反编译出C伪代码:decompile工具与Hex-Rays本地变量实战指南

ida-mcp-rs 是一个 Headless IDA Pro MCP 服务器(MCP Server for IDA Pro),它让 Claude Code、Cursor、Codex CLI 等 AI 助手直接"驱动" IDA Pro 完成逆向工程。其中最实用的能力,就是通过 decompile 工具把二进制函数一键反编译成 C 伪代码,再配合 Hex-Rays 本地变量工具,快速查看与修改函数内的局部变量。本文带你从零接入,走完"打开数据库 → 反编译 → 精修局部变量"的完整链路。

一、ida-mcp-rs 是什么,如何快速接入

💡 一句话理解:ida-mcp-rs 用原生 Rust 编写的 MCP 服务器,通过 idalib 无头(headless)方式驱动 IDA Pro。你不需要开着 IDA 图形界面,AI 助手调用工具即可返回反汇编、伪代码、交叉引用等结果。

安装有多种方式(Homebrew、Scoop、Nix、直接下载、源码构建),最快的是一行 Homebrew 命令:

brew install blacktop/tap/ida-mcp

然后把 MCP 服务器接入你的 AI 客户端(以 Claude Code 为例):

claude mcp add ida -- ida-mcp

不同平台只需配置对应的库路径环境变量,详见 README.md 的 "Platform setup" 部分:

  • macOS:默认 /Applications 下的 IDA 无需额外配置;若提示 Library not loaded: @rpath/libida.dylib,设置 DYLD_LIBRARY_PATH 指向 IDA 安装目录。
  • Linux:默认查找 ~/ida-pro-9.4,其他位置设置 IDADIR。
  • Windows:最简单是把 ida-mcp.exe 复制到 IDA 安装目录,或设置 IDADIR 并加入 PATH。

前提:需要 IDA Pro 9.4(或 9.5 beta)及有效授权;反编译能力依赖 Hex-Rays 反编译器插件。

二、三步完成 decompile 反编译 C 伪代码

🚀 核心流程只有三步:打开数据库 → 完成自动分析 → 调用 decompile。

第 1 步:用 open_idb 打开二进制或 IDB

open_idb(path: "~/samples/malware")

原始二进制默认保存为同目录的 <输入名>.i64;如果输入目录只读,用 idb_out 指定数据库输出位置。

第 2 步:等待自动分析就绪

反编译依赖已完成的自动分析。对较大的二进制,建议后台运行分析并轮询进度:

analyze_funcs(background: true)                    # 返回 task_id
task_status(task_id: "analyze-<random>")           # 轮询进度

小文件也可用前台模式 analyze_funcs(background: false) 直接等待完成。

第 3 步:解析函数地址,调用 decompile

resolve_function(name: "main")     # 拿到函数起始地址
decompile(address: "0x100000f00")  # 输出 C 伪代码

decompile 工具"使用 Hex-Rays 反编译器(如果可用)反编译函数,返回类 C 伪代码,接受地址或函数名"。它的工具定义位于 tool_registry.rs,底层实现在 disasm.rs。

三、decompile 工具组:不止 decompile 一个

🧩 完整 decompile 工具组共 4 个工具,见 TOOLS.md:

工具 说明
decompile 把函数反编译为 C 伪代码
pseudocode_at 获取指定地址或地址范围的伪代码片段(而非整个函数)
list_lvars 列出函数中反编译器的局部变量与参数
list_pseudocode_comments 列出函数伪代码的行尾注释位置

其中 pseudocode_at 与 decompile 的区别:decompile 返回整个函数的伪代码;pseudocode_at 只返回给定地址(例如一个基本块)对应的那些语句,适合"我只想看这一段"的场景。

四、list_lvars 实战:查看与重命名 Hex-Rays 本地变量

4.1 用 list_lvars 列出局部变量与参数

list_lvars 是精修局部变量的入口,传入一个函数地址或精确的 target_name:

list_lvars(target_name: "interesting_function")

它会返回每个局部变量/参数的:名称、类型、位置、定义地址、大小、是否为参数(is_argument)、是否用户命名,以及一个关键的不透明 locator。结果支持分页(limit/offset)。实现见 lvars.rs。

4.2 为什么必须记住 locator

rename_lvar 和 set_lvar_type 都需要精确定位"到底是哪一个局部变量"。它们接受同一个函数选择器,外加 lvar_locator 或 lvar_name 二者之一:

rename_lvar(
  target_name: "interesting_function",
  lvar_locator: "<list_lvars 返回的 locator>",
  new_name: "count"
)
set_lvar_type(
  target_name: "interesting_function",
  lvar_locator: "<list_lvars 返回的 locator>",
  decl: "unsigned int"
)
save_idb()

强烈建议优先使用 list_lvars 返回的不透明 locator,而不是显示名(如 v1)。因为原型变化后,v1 这类名字可能"漂移到"另一个局部变量;而 locator 是稳定的编辑凭据。过期的或有歧义的 locator 会直接失败、不做任何修改,从机制上杜绝误改。

set_lvar_type 的 decl 参数就是 C 类型声明,例如 unsigned int,用于修正反编译器猜错的类型。相关工具定义见 tool_registry.rs 与 tool_registry.rs。

4.3 改完记得 save_idb

rename_lvar、set_lvar_type 属于"修改数据库"的操作族。这类工具统一规则:只接受恰好一个地址或一个符号名,名称必须完全匹配(含大小写);差一点也不会改动,而是返回最多 8 个相似名称供参考。

完成后调用 save_idb() 把编辑检查点到磁盘——这是唯一保证编辑落盘的方式。close_idb 也会保存。

工具筛选提示:list_lvars 属于 decompile 工具集,rename_lvar 属于 editing,set_lvar_type 属于 types。若你只想用精简的 28 工具 lean profile,需手动加入:--profile=lean --tools=list_lvars,rename_lvar,set_lvar_type。

五、顺手给伪代码加行尾注释

📝 想在 Hex-Rays 伪代码里写持久化注释,用 list_pseudocode_comments 列出每行可注释位置的 locator、地址、文本与现有注释,再把其中某个 locator 传给 set_pseudocode_comment 作为 comment_locator;传空注释即删除该行注释。

list_pseudocode_comments(target_name: "interesting_function")
set_pseudocode_comment(target_name: "interesting_function",
  comment_locator: "<list_pseudocode_comments 返回的 locator>",
  comment: "validated input")
save_idb()

注意:set_comments 改的是反汇编注释,在伪代码里看不到;两者不要混用。

六、避坑清单

  • ✅ 反编译前确保自动分析完成,必要时用 analyze_funcs(background: true) + task_status 轮询。
  • ✅ 需要 Hex-Rays 授权与已完成的分析,decompile 才可用。
  • ✅ 编辑局部变量时优先用 locator,而不是显示名 v1。
  • ✅ 每次改完调用 save_idb() 检查点落盘。
  • ⚠️ 名称必须完全匹配(含大小写),接近匹配不会生效。
  • ⚠️ set_comments 改反汇编注释,set_pseudocode_comment 改伪代码注释,别搞混。

完整工具目录与发现工作流(tool_catalog / tool_help)见 TOOLS.md;各工具组划分与 lean profile 的取舍见 README.md。回归测试可参考 stdio_decompile.sh 与 stdio_lvars.py,前者覆盖 Hex-Rays 反编译链路,后者覆盖局部变量编辑与持久化。

按这套流程,你就能让 AI 助手像"老逆向"一样,把二进制函数稳定地读成 C 伪代码,并把 v1、v2 精修成真正的业务含义。

登录后查看全文
ida-mcp-rs