用ida-mcp-rs让AI反编译出C伪代码:decompile工具与Hex-Rays本地变量实战指南
用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 工具leanprofile,需手动加入:--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 精修成真正的业务含义。