IDA Pro 接入 MCP 工具完整教程：让 AI 驱动逆向工程#

1.1 版本硬性要求#

⚠️ 注意：IDA Free 免费版不支持该插件。Python 版本需与 IDA 内置 Python 一致，可使用 idapyswitch 工具切换。

1.2 环境预检查#

在开始安装前，请确认以下条件：

• IDA Pro 已正常安装并可以打开二进制文件
• Python 版本符合要求：python --version
• Git 已安装（用于从 GitHub 拉取依赖）：git --version
• 网络连接正常（pip 需要下载依赖包）

步骤 1：安装 ida-pro-mcp 包#

打开终端，使用 pip 从 GitHub 直接安装最新版：

1
# 如果有旧版本，先卸载
2
pip uninstall ida-pro-mcp -y
3

4
# 安装最新版本
5
pip install git+https://github.com/mrexodia/ida-pro-mcp.git

如果国内网络访问 GitHub 较慢，可以使用镜像加速：

1
pip install git+https://gitcode.com/gh_mirrors/id/ida-pro-mcp.git

步骤 2：安装 IDA 插件并配置客户端#

执行安装命令，该命令会自动完成三件事：

1. 将插件安装到 IDA Pro 的 plugins 目录
2. 配置常见的 MCP 客户端（Cursor、Claude Desktop、Windsurf 等）
3. 生成 MCP 配置文件

1
ida-pro-mcp --install

安装成功后，终端会输出类似以下信息：

1
✅ Installed plugin to C:\Users\xxx\AppData\Roaming\Hex-Rays\IDA Pro\plugins\mcp-plugin.py
2
✅ Configured Cursor MCP
3
✅ Configured Claude Desktop MCP

步骤 3：验证安装#

1. 完全退出 IDA Pro 和 MCP 客户端（注意 Claude 可能在系统托盘中后台运行）
2. 重新启动 IDA Pro，打开任意二进制文件
3. 检查 IDA 顶部菜单栏是否出现 IDA MCP 菜单项

如果菜单出现，说明插件已成功加载。

步骤 4：手动补充客户端配置（自动写入失败时）#

如果自动配置未生效，可以手动获取配置：

1
ida-pro-mcp --config

然后将输出的 JSON 配置复制到对应客户端的 MCP 配置文件中：

• Cursor：~/.cursor/mcp.json
• Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json
• Trae：设置 → MCP → 添加服务器
• VS Code：.vscode/mcp.json

一个典型的 MCP 配置如下：

1
{
2
  "mcpServers": {
3
    "ida-pro": {
4
      "command": "python",
5
      "args": ["-m", "ida_pro_mcp.server"],
6
      "env": {}
7
    }
8
  }
9
}

3.1 基础查询类#

3.2 函数分析类#

3.3 数据查询类#

3.4 修改类#

3.5 调试类（需加 --unsafe 标志）#

4.1 准备工作#

1. 在 IDA Pro 中打开目标 CrackMe 二进制文件
2. 等待初始自动分析完成
3. 在 MCP 客户端（如 Cursor）中确认连接状态

4.2 编写分析 Prompt#

LLM 处理数字进制转换容易产生幻觉，因此编写 Prompt 时需要特别强调使用工具而非手动转换。以下是一个经过验证的 Prompt 模板：

1
你的任务是分析 IDA Pro 中的一个 CrackMe 程序。
2

3
分析策略：
4
1. 先 get_metadata 获取基本信息，get_entry_points 获取入口点
5
2. 定位 main 函数（通过入口点追踪或搜索字符串定位）
6
3. 使用 decompile_function 获取函数伪代码
7
4. 分析伪代码逻辑，识别关键比较和条件跳转
8
5. 使用 rename_function 和 rename_local_variable 重命名函数和变量
9
6. 使用 set_comment 为关键地址添加注释
10
7. 使用 set_function_prototype 修正函数原型
11
8. 使用 set_local_variable_type 修正变量类型（尤其是指针和数组类型）
12

13
⚠️ 重要规则：
14
- 绝不手动转换数字进制，始终使用 convert_number 工具
15
- 在读取分析结果前，确保 IDA 自动分析已完成
16
- 找到密码/flag 后，明确告知用户

4.3 分析对话示例#

以下是 AI 使用 MCP 工具分析 CrackMe 的典型交互过程：

AI: get_metadata → 获取到 x64 PE 文件信息，基址 0x140000000

AI: get_entry_points → 发现入口点 start 在 0x140001000

AI: get_function_by_name("main") → 定位到 main 函数在 0x140001200

AI: decompile_function(0x140001200) → 获取反编译伪代码，发现 strcmp 调用

AI: rename_local_variable(0x140001200, "v5", "user_input") → 重命名变量

AI: set_comment(0x140001250, "密码验证：将用户输入与硬编码密钥比较") → 添加注释

AI: 最终分析出密码为 P@ssw0rd_2024!

5.1 Cursor#

安装 ida-pro-mcp 后，Cursor 会自动配置。手动配置方式：

在 ~/.cursor/mcp.json 中添加：

1
{
2
  "mcpServers": {
3
    "ida-pro": {
4
      "command": "python",
5
      "args": ["-m", "ida_pro_mcp.server"]
6
    }
7
  }
8
}

然后在 Cursor 的 Composer 面板（Ctrl+I）中，选择 Agent 模式即可使用。

5.2 Claude Desktop#

Claude Desktop 配置在安装时自动完成。如需手动配置，编辑对应平台的配置文件：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

配置格式与 Cursor 一致。配置完成后必须从系统托盘完全退出 Claude Desktop 再重新启动。

5.3 Trae / VS Code#

在 Trae 中：

1. 打开设置 → MCP → 添加 MCP 服务器
2. 输入名称 ida-pro
3. 命令选择 python，参数为 -m ida_pro_mcp.server

在 VS Code 中使用 Agent Mode（GitHub Copilot），配置方式与 Cursor 相同。

5.4 Windsurf#

Windsurf 的配置文件位于 ~/.codeium/windsurf/mcp.json，内容与其他客户端一致。

6.1 修改插件监听地址#

默认情况下，IDA MCP 插件只监听 127.0.0.1:13337，需要改为 0.0.0.0 以允许外部连接。

方法 A：修改插件源文件（永久生效，推荐）

编辑 IDA plugins 目录下的 mcp-plugin.py，找到绑定地址的代码行：

1
# 将 127.0.0.1 改为 0.0.0.0
2
server = await asyncio.start_server(handle_client, "0.0.0.0", 13337)

方法 B：通过 IDA MCP 菜单设置

在 IDA Pro 的 IDA MCP 菜单中修改监听地址并保存。

6.2 防火墙配置#

确保端口 13337 允许入站连接：

1
# 以管理员身份运行
2
New-NetFirewallRule -DisplayName "IDA MCP" -Direction Inbound -Port 13337 -Protocol TCP -Action Allow

6.3 客户端配置#

客户端 MCP 配置中将地址改为服务器的实际 IP：

1
{
2
  "mcpServers": {
3
    "ida-pro": {
4
      "command": "python",
5
      "args": ["-m", "ida_pro_mcp.server", "--host", "192.168.1.100"]
6
    }
7
  }
8
}

7.1 IDA 顶部没有 “IDA MCP” 菜单#

• 确认已加载二进制文件（空项目不会显示菜单）
• 检查 IDA Python 版本：打开 IDA 的 Output 窗口查看 Python 版本号
• 查看 Output 窗口中是否有插件加载报错信息

7.2 连接失败：Connection Refused（端口 13337）#

• 确认 IDA Pro 已打开并加载了二进制文件
• 确认防火墙未阻止 13337 端口
• 确认 mcp-plugin.py 文件在正确的 plugins 目录中

7.3 反编译失败#

• 确认 IDA Pro 安装了 Hex-Rays 反编译器（x86/x64/ARM 授权）
• 检查 decompile_function 传入的地址是否在一个有效的函数范围内

7.4 Python 版本不匹配#

• 运行 idapyswitch 查看 IDA 当前使用的 Python 版本路径
• 确保安装 ida-pro-mcp 的 Python 环境版本与之一致