⚙

IDA Pro MCP服务器

IDA Pro MCP服务器是一个用于IDA Pro的MCP协议服务，支持二进制文件的反编译和分析，适用于逆向工程场景。

作者 By mrexodia

本地部署逆向工程二进制分析

GitHub

IDA Pro MCP

简单 MCP服务器允许IDA Pro中的氛围反转。

https://github.com/user-attachments/assets/6ebeaa92-a9db-43fa-b756-eececce2aca0

视频的二进制文件和提示可在 mcp反向数据集存储库。

先决条件

python (3.11或更高)
使用 idapyswitch 切换到最新的Python版本
IDA Pro （8.3或更高，推荐9）， 不支持IDA Free
支持的MCP客户端（选择您喜欢的一个）
Amazon Q开发者命令行界面
增强代码
克劳德
克劳德代码
克莱恩
法典
Copilot命令行界面
心动
光标
双子星命令行工具
千码
基罗
LM 工作室
开放代码
Qodo Gen
通义千问代码专家
Roo代码
崔
VS Code
VS代码内部人员
扭曲
帆板运动
泽德
其他MCP客户端：运行 ida-pro-mcp --config 获取客户端的JSON配置。

安装

安装最新版本的IDA Pro MCP软件包：

SH``` 1 2pip uninstall ida-pro-mcp pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip


配置MCP服务器并安装IDA插件：

1ida-pro-mcp —install


**重要**：确保您完全重新启动IDA和MCP客户端，以便安装生效。一些客户端（如Claude）在后台运行，需要从托盘图标中退出。


[https://github.com/user-attachments/assets/65ed3373-a187-4dd5-a807-425dca1d8ee9](https://github.com/user-attachments/assets/65ed3373-a187-4dd5-a807-425dca1d8ee9)


*备注*：在插件菜单显示之前，您需要在IDA中加载一个二进制文件。


## 提示工程


LLMs容易产生幻觉，你需要明确你的提示。对于逆向工程，整数和字节之间的转换尤其成问题。下面是一个最小的示例提示，如果您使用不同的提示获得了良好的结果，请随时开始讨论或打开问题：


MD```
1
2
3
4
5
6
7
8
9
10Your task is to analyze a crackme in IDA Pro. You can use the MCP tools to retrieve information. In general use the following strategy:
- Inspect the decompilation and add comments with your findings
- Rename variables to more sensible names
- Change the variable and argument types if necessary (especially pointer and array types)
- Change function names to be more descriptive
- If more details are necessary, disassemble the function and add comments with your findings
- NEVER convert number bases yourself. Use the `int_convert` MCP tool if needed!
- Do not attempt brute forcing, derive any solutions purely from the disassembly and simple python scripts
- Create a report.md with your findings and steps taken at the end
- When you find a solution, prompt to user for feedback with the password you found

这个提示只是第一个实验，如果你找到了提高输出的方法，请分享！

另一个提示由 @公元1357年:

MD``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23Your task is to create a complete and comprehensive reverse engineering analysis. Reference AGENTS.md to understand the project goals and ensure the analysis serves our purposes. Use the following systematic methodology:

Decompilation Analysis
- Thoroughly inspect the decompiler output
- Add detailed comments documenting your findings
- Focus on understanding the actual functionality and purpose of each component (do not rely on old, incorrect comments)
Improve Readability in the Database
- Rename variables to sensible, descriptive names
- Correct variable and argument types where necessary (especially pointers and array types)
- Update function names to be descriptive of their actual purpose
Deep Dive When Needed
- If more details are necessary, examine the disassembly and add comments with findings
- Document any low-level behaviors that aren’t clear from the decompilation alone
- Use sub-agents to perform detailed analysis
Important Constraints
- NEVER convert number bases yourself - use the int_convert MCP tool if needed
- Use MCP tools to retrieve information as necessary
- Derive all conclusions from actual analysis, not assumptions
Documentation
- Produce comprehensive RE/*.md files with your findings
- Document the steps taken and methodology used
- When asked by the user, ensure accuracy over previous analysis file
- Organize findings in a way that serves the project goals outlined in AGENTS.md or CLAUDE.md


直播讨论提示并显示一些真实世界的恶意软件分析：


[![](https://img.youtube.com/vi/iFxNuk3kxhk/0.jpg)](https://www.youtube.com/watch?v=iFxNuk3kxhk)


## 提高LLM准确性的技巧


大型语言模型（LLM）是强大的工具，但它们有时会难以处理复杂的数学计算或表现出“幻觉”（编造事实）。确保告诉LLM使用 `int_convert` MCP工具，您可能还需要 [数学mcp](https://github.com/EthanHenrickson/math-mcp) 对于某些操作。


另一件要记住的事情是，LLM在混淆的代码上表现不佳。在尝试使用LLM解决问题之前，先看看二进制文件，花一些时间（自动）删除以下内容：


- 字符串加密
- 导入哈希
- 控制流扁平化
- 代码加密
- 反反编译技巧


您还应该使用Lumina或FLIRT等工具来尝试解析所有开源库代码和C++STL，这将进一步提高准确性。


## 苏格兰和南方能源公司运输和无头MCP


您可以运行SSE服务器连接到用户界面，如下所示：


SH```
1uv run ida-pro-mcp --transport http://127.0.0.1:8744/sse

安装后 idalib 您还可以运行一个无头SSE服务器：

SH``` 1uv run idalib-mcp —host 127.0.0.1 —port 8745 path/to/executable


*备注*：The `idalib` 该功能由以下人员贡献 [Willi Ballenthin](https://github.com/williballenthin).


## 无头idalib会话模型


使用 `--isolated-contexts` 为了实现严格的每传输隔离：


SH```
1uv run idalib-mcp --isolated-contexts --host 127.0.0.1 --port 8745 path/to/executable

为什么使用 `--isolated-contexts`?

当多个代理连接到同一个代理时使用它 idalib-mcp 服务器和您想要确定性上下文隔离：

防止一个代理意外更改另一个代理的活动会话。
安全地运行并发分析（例如，代理A在二进制X上，代理B在二进制Y上）。
通过将多个代理绑定到同一个开放会话ID，仍然允许有意协作。
提高可重复性，因为每个代理的上下文绑定都是显式的。

当 --isolated-contexts 已启用：

每个传输上下文都有自己的绑定(Mcp-Session-Id 为了 /mcp, session 为了 /sse, stdio:default 用于stdio）。
对于依赖IDB的工具/资源，未绑定的上下文会很快失败。
idalib_switch(session_id) 和 idalib_open(...) 仅绑定调用者上下文。

流式HTTP行为

随着 --isolated-contexts，启用了严格的Streamable HTTP会话语义，包括 Mcp-Session-Id 验证。

上下文工具

idalib_open(input_path, ...)：打开二进制文件并将其绑定到活动上下文策略。
idalib_switch(session_id)：将活动上下文策略重新绑定到现有会话。
idalib_current()：返回绑定到活动上下文策略的会话。
idalib_unbind()：删除活动上下文绑定。
idalib_list()：包括 is_active, is_current_context，以及 bound_contexts.

MCP资源

资源表示遵循MCP哲学的可浏览状态（只读数据）。

IDB核心州：

ida://idb/metadata -IDB文件信息（路径、拱、基、大小、哈希）
ida://idb/segments -具有权限的内存段
ida://idb/entrypoints -入口点（主、TLS回调等）

UI状态：

ida://cursor -当前光标位置和功能
ida://selection -当前选择范围

类型信息：

ida://types -所有本地类型
ida://structs -所有结构/工会
ida://struct/{name} -带字段的结构定义

查询：

ida://import/{name} -按名称导入详细信息
ida://export/{name} -按名称导出详细信息
ida://xrefs/from/{addr} -地址的交叉引用

核心功能

lookup_funcs(queries)：按地址或名称获取函数（自动检测，接受列表或逗号分隔的字符串）。
int_convert(inputs)：将数字转换为不同的格式（十进制、十六进制、字节、ASCII、二进制）。
list_funcs(queries)：列表函数（分页、筛选）。
list_globals(queries)：列出全局变量（分页、筛选）。
imports(offset, count)：列出所有带有模块名称的导入符号（分页）。
decompile(addr)：在给定地址处分解函数。
disasm(addr)：带完整细节（参数、堆栈框架等）的反汇编函数。
xrefs_to(addrs)：获取地址的所有交叉引用。
xrefs_to_field(queries)：获取对特定结构字段的交叉引用。
callees(addrs)：获取地址处函数调用的函数。

修改操作

set_comments(items)：在反汇编和反编译器视图中的地址处设置注释。
patch_asm(items)：地址处的补丁组装说明。
declare_type(decls)：在本地类型库中声明C类型。
define_func(items)：在地址处定义功能。可选择指定 end 对于明确的界限。
define_code(items)：将字节转换为地址处的代码指令。
undefine(items)：取消定义地址处的项，转换回原始字节。可选择指定 end 或 size.

内存读取操作

get_bytes(addrs)：读取地址处的原始字节。
get_int(queries)：使用ty读取整数值（i8/u64/i16le/i16be/etc）。
get_string(addrs)：读取以null结尾的字符串。
get_global_value(queries)：按地址或名称读取全局变量值（自动检测、编译时值）。

堆栈框架操作

stack_frame(addrs)：获取函数的堆栈帧变量。
declare_stack(items)：在指定的偏移量处创建堆栈变量。
delete_stack(items)：按名称删除堆栈变量。

结构操作

read_struct(queries)：读取特定地址的结构字段值。
search_structs(filter)：按名称模式搜索结构。

调试器操作（扩展）

默认情况下，调试器工具是隐藏的。启用 ?ext=dbg 查询参数：

1http://127.0.0.1:13337/mcp?ext=dbg

控制：

dbg_start()：启动调试器进程。
dbg_exit()：退出调试器进程。
dbg_continue()：继续执行。
dbg_run_to(addr)：跑到地址。
dbg_step_into()：进入指令。
dbg_step_over()：跳过指令。

断点：

dbg_bps()：列出所有断点。
dbg_add_bp(addrs)：添加断点。
dbg_delete_bp(addrs)：删除断点。
dbg_toggle_bp(items)：启用/禁用断点。

寄存器：

dbg_regs()：所有寄存器，当前线程。
dbg_regs_all()：所有寄存器，所有线程。
dbg_regs_remote(tids)：所有寄存器，特定线程。
dbg_gpregs()：GP寄存器，当前线程。
dbg_gpregs_remote(tids)：GP寄存器，特定线程。
dbg_regs_named(names)：命名寄存器，当前线程。
dbg_regs_named_remote(tid, names)：命名寄存器，特定线程。

堆栈和内存：

dbg_stacktrace()：使用模块/符号信息调用堆栈。
dbg_read(regions)：从调试进程中读取内存。
dbg_write(regions)：将内存写入调试进程。

高级分析操作

py_eval(code)：在IDA上下文中执行任意Python代码（返回带有result/stout/stderr的dict，支持Jupyter风格的求值）。
analyze_funcs(addrs)：全面的函数分析（反编译、汇编、外部参照、被调用者、调用者、字符串、常量、基本块）。

模式匹配和搜索

find_regex(queries)：使用不区分大小写的正则表达式（分页）搜索字符串。
find_bytes(patterns, limit=1000, offset=0)：查找二进制中的字节模式（例如“48 8B？？？？”）。最大限额：10000。
find_insns(sequences, limit=1000, offset=0)：在代码中查找指令序列。最大限额：10000。
find(type, targets, limit=1000, offset=0)：高级搜索（即时值、字符串、数据/代码引用）。最大限额：10000。

控制流分析

basic_blocks(addrs)：获取继承者和前任的基本块。

类型操作

set_type(edits)：将类型应用于函数、全局变量、局部变量或堆栈变量。
infer_types(addrs)：使用十六进制射线或启发式方法推断地址处的类型。

出口业务

export_funcs(addrs, format)：以指定格式导出函数（json、c_header或原型）。

图的运算

callgraph(roots, max_depth)：从具有可配置深度的根函数构建调用图。

批量操作

rename(batch)：函数、全局变量、局部变量和堆栈变量的统一批重命名操作（接受带可选参数的dict func, data, local, stack 按键）。
patch(patches)：一次修补多个字节序列。
put_int(items)：使用ty（i8/u64/i16le/i16be/etc）写入整数值。

主要特点：

安全型API：所有函数都使用具有TypedDict模式的强类型参数，以获得更好的IDE支持和LLM结构化输出
批量优先设计：大多数操作同时接受单个项目和列表
一致的错误处理：所有批处理操作返回 [{..., error: null|string}, ...]
基于光标的分页：搜索函数返回 cursor: {next: offset} 或 {done: true} （默认限制：1000，强制最大值：10000，以防止令牌溢出）
演出：字符串以基于MD5的无效方式缓存，以避免重复 build_strlist 大型项目中的电话

与其他MCP服务器的比较

周围有一些IDA Pro MCP服务器，但我创建了自己的服务器，原因有几个：

安装应完全自动化。
其他插件的架构使得快速添加新功能变得困难（不必要的依赖关系的样板太多）。
学习新技术很有趣！

如果你想查看它们，这里有一个列表（按照我发现它们的顺序）：

请在此处打开PR以添加您的IDA Pro MCP服务器。

发展

添加新功能是一个超级简单和简化的过程。你所要做的就是添加一个新的 @tool 中模块化API文件的函数 src/ida_pro_mcp/ida_mcp/api_*.py 您的功能将在MCP服务器中可用，无需任何额外的样板！下面是我添加的视频 get_metadata 在2分钟内完成功能（包括测试）：

https://github.com/user-attachments/assets/951de823-88ea-4235-adcb-9257e316ae64

要测试MCP服务器本身：

SH``` 1npx -y @modelcontextprotocol/inspector


这将打开一个web界面http://localhost:5173并允许您与MCP工具进行交互以进行测试。


为了测试，我创建了一个指向IDA插件的符号链接，然后直接向POST发送JSON-RPC请求 `http://localhost:13337/mcp`.之后 [启用符号链接](https://learn.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) 您可以运行以下命令：


SH```
1uv run ida-pro-mcp --install

生成直接提交的变更日志 main:

SH``` 1git log —first-parent —no-merges 1.2.0..main “—pretty=- %s”