用自然语言向你的 AI 智能体询问 IDA Pro 中打开的任何二进制文件。它从实时数据库中作答。
[!TIP] 你不需要懂 SQL。 你用自然语言提问:“谁调用了这个函数?”、“重命名这些并加上注释”、“这个二进制文件是做什么的?”。你的智能体会替你编写并执行 SQL。SQL 只是 idasql 与智能体交流所用的语言,而每个智能体本就懂它。 你随时可以自己输入 SQL,但你永远不必这么做。
[!NOTE] idasql 不导出任何内容。 尽管名字里带有“sql”,idasql 从不把你的 IDB 转换或导出为 SQL 数据库,也不导出为任何其他东西。它是构建在 IDA SDK 之上的虚拟 SQL 接口:每次查询都读取你实时的 IDB,每次更改都直接写回其中。
IDASQL 为 AI 编程智能体提供对 IDA 数据库的完整、实时访问:70 多张表涵盖函数、交叉引用、字符串、类型、伪代码等,全部可读可写。它可与 Claude Code、Copilot CLI、Codex 或任何 MCP(Model Context Protocol)客户端配合使用,也可与任何支持 HTTP 的工具配合使用。它由 Elias Bachaalany 创建。

▶ 观看:Vibe Reverse Engineering #1: IDASQL & the xSQL Concept
可以完全无界面地工作,完全不打开 IDA 窗口;也可以直接在你已打开的 IDA 中工作。智能体两种方式都能处理。
/idasql:connect Open sample.exe in the background and let's analyze it together.
代理在后台运行 IDA(idasql -s)并自行分析原始二进制文件。你可以打开任意数量的数据库,并在你要求时保存它们。
在 IDA 中无需任何设置。像往常一样打开你的数据库,然后询问你的代理。它会自行找到你的 IDA:
你: target.dll 里有多少个函数?
代理随后运行:
$ idasql instances # every running IDA: target.dll.i64 is pid 4242, no SQL server
$ idasql http start 4242
remote control is off for target.dll.i64 (pid 4242)
turn it on with: idasql remote on 4242 (or .remote on in that IDA)
$ idasql remote on 4242 && idasql http start 4242
remote control on for target.dll.i64 (pid 4242)
http://127.0.0.1:8174
然后它会检查自己是否连接到了正确的数据库,并进行计数:
Agent: target.dll 有 812 个函数。那个 IDA 没有在提供 SQL 服务,所以我开启了它的远程 控制,并在 localhost 上启动了一个 HTTP 服务器。
idasql remote off 4242和idasql http stop 4242可以撤销这两项操作。
整个交互过程大约需要 30 秒。Agent 只会为你所询问的那个数据库开启远程控制。
更想自己指定 Agent? 经典方式一如既往地有效。在 IDA 的
idasql> 提示符下输入 .http start。IDA 会打印 IDASQL HTTP server: http://127.0.0.1:8174,并
将连接说明复制到剪贴板。然后:
/idasql:connect Let's work with this database: http://127.0.0.1:8174
运行一次 .pin http,该数据库每次打开时都会启动其服务器。
/idasql:connect 自行指定。ida:// 链接,可让 IDA 跳转到对应代码(IDA 9.4+)。idasql -s db.i64 --mcp,或在 IDA 内执行 .mcp start,任何 MCP(Model Context Protocol)客户端都会获得一个 idasql_query 工具。.pin http(或 .pin mcp),该数据库每次打开时都会提供服务,因此你的 agent 无需任何步骤即可连接。idasql rescue 可保存冻结 IDA 的工作,idasql close 可干净地结束一个 IDA。| 你可能听说过 | 实际情况 |
|---|---|
| “我必须学习 SQL。” | 不需要。你用自然语言提问,由 agent 编写 SQL。 |
| “它只能读取。” | 它也能写入:重命名、注释、类型、结构体、原型、补丁、书签和撤销检查点。 |
| “它会先导出数据库。” | 不会。每个查询都针对已打开的数据库实时运行,每项更改都会立即显示在 IDA 中。 |
| “它会取代 IDA。” | 它运行在你的 IDA Pro(9.2 至 9.5)和你的许可证之上。伪代码表需要 Hex-Rays 反编译器。 |
| “它只能在无头模式下工作”(或“只能在 GUI 中工作”)。 | 两者皆可,或同时使用,并可同时处理多个数据库。 |
| “它只适用于 Claude。” | 任何 agent 都可以:这些技能为 Claude Code、Copilot CLI 和 Codex 提供,HTTP 和 MCP 则服务于其余场景。 |
| “它只用于恶意软件。” | IDA 能打开的任何二进制文件:驱动程序、固件、游戏、库。 |
| “agent 会编造内容。” | 它的答案来自对你数据库的查询,并且在 IDA 9.4+ 上,链接可让你点击并在 IDA 中逐一检查。 |
| “我的二进制文件会上传到云端。” | idasql 在你的机器上运行,其服务器仅监听 localhost。你的 agent 的模型会看到 agent 读取的内容,因此请相应地选择你的 agent。 |
下载适用于你的 IDA 版本的发行版,来自 Releases(ida92、ida93、ida94 或 ida95;构建版本与 IDA 版本相关):
| 压缩包 | 内容 |
|---|---|
*-plugin.zip | 兼容 HCLI 的插件(Windows x64、Linux x64、macOS ARM64) |
*-cli.zip | idasql 命令行,按主机架构区分 |
*-arm64-plugin.zip | ARM64 插件,需手动安装:Linux(IDA 9.3+)和 Windows(IDA 9.4+) |
将 idasql 放在 IDA 旁边,将 IDA 的目录加入 PATH,然后用 idasql --version 检查。
将技能添加到你的 agent。在 Claude Code 或 Copilot CLI 中:
/plugin marketplace add allthingsida/idasql-skills
然后从该市场安装 idasql。对于 Codex,请参阅 idasql-skills。
$ idasql instances
PID HOST IDA SQL REMOTE STATE DATABASE
4242 gui 9.5 http://127.0.0.1:8174 on ok target.dll.i64
5150 gui 9.5 - off ok malware.exe.i64
6001 idalib 9.5 http://127.0.0.1:8123 - ok firmware.bin.i64
机器上每个 IDA 实例都会被列出:GUI 窗口、idasql -s 会话,甚至没有 idasql 的 IDA(9.4+)。当某个实例不提供 SQL 时,agent 会启动它的服务器,使用的动词与你在 IDA 中输入的一致:
| 在 IDA 中 | 从任意终端 | 从 SQL |
|---|---|---|
.http start / .http stop | idasql http start <db|pid> / stop | UPDATE ida_instances SET start = 'http' WHERE pid = N |
.mcp start / .mcp stop | idasql mcp start <db|pid> / stop | UPDATE ida_instances SET start = 'mcp' WHERE pid = N |
.remote on / .remote off | idasql remote on <db|pid> / off | UPDATE ida_instances SET remote = 1 WHERE pid = N |
远程控制默认关闭,并按数据库单独设置。每个请求都会出现在该 IDA 的 Output 窗口中,并附带发起请求的进程。服务器绑定到 localhost,且从不发放 token。更想手动连接?.http start 加上粘贴的 URL 依然和以前一样可用。
拿一个编译后的二进制文件,还原出干净、可完整重新编译的源代码:真实的名称、真实的类型、真实的结构体,以及能够再次构建的代码。
/idasql:re-source Start at the entry point and recover this binary bottom-up: name every function, rename locals, recover the structs behind the pointer arithmetic, and fix the prototypes.
/idasql:types Recover the struct this function fills in, apply it, and show me the pseudocode again.
智能体逐个函数地处理程序:
*(DWORD *)(a1 + 0x10) 这类模式转换为真正的结构体和枚举;所有内容都会实时保存到你的 IDA 数据库中。一旦不再有 sub_* 残留,智能体就会将程序输出为干净的源文件,并附带恢复类型的头文件,然后重新构建它。
vibe-re 收集了以这种方式重建的真实二进制文件:恶意软件命令与控制(C2)代码、内核驱动程序及其带类型的客户端库。
SELECT f.name, dl.uri FROM funcs f
JOIN deep_links dl ON dl.resource = 'functions' AND dl.addr = f.addr AND dl.view = 'pseudocode'
ORDER BY f.size DESC LIMIT 5;
代理会将这些写成 [sub_401130](ida:///sample.exe.i64/functions?rva=0x1130&view=pseudocode&idb_path=...)。
点击其中一个,IDA 就会跳转到其伪代码。如果没有 IDA 打开该数据库,它会启动一个。
运行一次 idasql link register 来处理 ida:// 链接。链接用于 IDA 窗口;关于无头会话的
回答使用纯名称。
你: 编写一个 IDAPython 脚本,列出对 CreateFileW 的每一次调用,并给出每次 调用所在的函数,然后在目标数据库中运行它
代理会编写该脚本:
import idautils, idc, ida_funcs