ida-pro-mcp 安装与配置指南（Windows + IDA Pro 9.4 + Trae）

本文档记录 ida-pro-mcp 1.4.0 在本机（Windows、IDA Professional 9.4、Trae CN）的完整安装过程，可按步骤复现。
安装日期：2026-09-06

---

1. 环境信息

项目	值
操作系统	Windows
Python	3.14.6（C:\Users\DINGJINJIN\AppData\Local\Python\pythoncore-3.14-64）
pip	26.2.1
uv	0.12.0（本次安装未使用，pip 即可）
IDA Pro	IDA Professional 9.4（C:\Program Files\IDA Professional 9.4）
MCP 源码包	C:\DiagLogAnalyzer\ida-pro-mcp-1.4.0（版本 1.4.0）
MCP 客户端	Trae CN（手动配置，安装器不原生支持 Trae）

要求：Python ≥ 3.11、IDA Pro ≥ 8.3（IDA Free 不支持）。

---

2. 安装步骤

2.1 安装 ida-pro-mcp 包

pip install "C:\DiagLogAnalyzer\ida-pro-mcp-1.4.0"

这会把包安装到 site-packages，并在
C:\Users\DINGJINJIN\AppData\Local\Python\pythoncore-3.14-64\Scripts\
下生成 ida-pro-mcp.exe（该目录不在 PATH 中，后续需用完整路径调用）。

2.2 【关键】降级 mcp 到 1.x

pip install 会自动拉取最新的 mcp 2.x，而 ida-pro-mcp 1.4.0 依赖 mcp 1.x 的
FastMCP（2.x 中已改名为 MCPServer），直接运行会报错：

ModuleNotFoundError: No module named 'mcp.server.fastmcp'. This is mcp 2.x ...

解决方法——降级到 mcp 1.x：

pip install "mcp>=1.16.0,<2"

安装完成后 mcp 版本应为 1.29.1。

2.3 安装 IDA 插件

& "C:\Users\DINGJINJIN\AppData\Local\Python\pythoncore-3.14-64\Scripts\ida-pro-mcp.exe" --install

输出关键行：

Installed IDA Pro plugin (IDA restart required)
  Plugin: C:\Users\DINGJINJIN\AppData\Roaming\Hex-Rays\IDA Pro\plugins\mcp-plugin.py

说明：

• 插件以符号链接方式安装（指向 site-packages 中的 mcp-plugin.py，约 76KB）。
  在 PowerShell 中 Get-Item 显示 Length 为 0 属正常现象（reparse point 的显示方式），
  用 Get-Content ... | Measure-Object -Character 可验证实际内容完整。
• --install 还会尝试为 Cline / Roo Code / Claude Desktop / Cursor / Windsurf /
  Claude Code / LM Studio 自动写入 MCP 配置；本机检测到 Claude Code
  （~/.claude.json）并已自动配置，其余未安装的被跳过，属正常。
• 如需卸载：ida-pro-mcp.exe --uninstall。

2.4 在 Trae 中手动添加 MCP 服务器

Trae 不在自动配置支持列表中，需在 Trae 的 MCP 面板 → 添加 MCP 服务器 → 手动添加(JSON) 中粘贴：

{
  "mcpServers": {
    "ida-pro-mcp": {
      "command": "C:\\Users\\DINGJINJIN\\AppData\\Local\\Python\\pythoncore-3.14-64\\python.exe",
      "args": [
        "C:\\Users\\DINGJINJIN\\AppData\\Local\\Python\\pythoncore-3.14-64\\Lib\\site-packages\\ida_pro_mcp\\server.py"
      ],
      "timeout": 1800
    }
  }
}

也可以用 ida-pro-mcp.exe --config 命令随时重新生成这份 JSON。

2.5 启动与验证

1. 重启 IDA Pro，并打开一个二进制文件 / IDB（插件菜单需要加载了 IDB 才会出现）。

2. 在 IDA 中按 Ctrl+Alt+M（或菜单 Edit → Plugins → MCP）启动插件，
   插件将在 http://localhost:13337/mcp 监听。

3. 重启 Trae，在 MCP 面板中启用 ida-pro-mcp。

4. 调用 check_connection 工具验证，成功时返回：

   Successfully connected to IDA Pro (open file: <当前打开的文件名>)
   

5. 可再调用 get_metadata 获取当前 IDB 的路径、基址、MD5 等信息，进一步确认工具可用。

连通性验证结果（本机）：

链路	状态
Trae → MCP 服务器（stdio）	✅ 22 个工具已加载
MCP 服务器 → IDA 插件（localhost:13337）	✅ 已连接

---

3. 常见问题排查

现象	原因与解决
No module named 'mcp.server.fastmcp'	mcp 被装成 2.x，执行 pip install "mcp>=1.16.0,<2" 降级
check_connection 返回 “Failed to connect to IDA Pro!”	IDA 中未启动插件，按 Ctrl+Alt+M；或 IDA 中没有打开 IDB
IDA 菜单里找不到 Edit → Plugins → MCP	没有加载二进制文件，先打开一个文件再查看菜单
插件文件显示 0 字节	符号链接的正常显示，实际内容完整，无需处理
ida-pro-mcp 命令找不到	Scripts 目录不在 PATH，用完整路径调用 .exe，或把该目录加入 PATH
修改了 ~/.claude.json 等配置后不生效	需完全重启对应客户端（Claude 需从托盘退出）

---

4. 功能速览

安全工具（默认可用，约 40 个）：get_metadata、list_functions、list_strings_filter、
decompile_function、disassemble_function、get_xrefs_to、get_callers / get_callees、
set_comment、rename_local_variable / rename_global_variable / rename_function、
set_function_prototype、declare_c_type、get_stack_frame_variables、
search_structures、read_memory_bytes、convert_number 等。

不安全工具（需 --unsafe 启动参数，仅在调试时使用）：dbg_start_process、
dbg_set_breakpoint、dbg_step_into / dbg_step_over、dbg_get_registers、
dbg_get_call_stack 等调试器控制类工具。

如需启用调试器工具，在 Trae 的 MCP 配置 args 末尾追加 "--unsafe"。

提示：LLM 处理数值进制转换容易出错，让模型使用 convert_number 工具而不是自己换算。

---

5. 相关链接

名称	链接	说明
ida-pro-mcp 1.4.0 Release	https://github.com/mrexodia/ida-pro-mcp/releases/tag/1.4.0	本文档安装版本的官方发布页（2025-10-06 发布）。相比 1.3.0 新增：idalib 无头 MCP 服务器、调试器工具（dbg_*）、全局变量列表、结构体字段交叉引用、内存读取函数、栈变量操作、补丁字节码等。本机安装的 C:\DiagLogAnalyzer\ida-pro-mcp-1.4.0 源码包与此 Release 对应
IDA SDK	https://github.com/HexRaysSA/ida-sdk	Hex-Rays 官方 SDK 仓库（含 include/ 头文件、docs/、许可证说明）。IDA Pro 9.x 自带 SDK（位于安装目录 include/、plugins/），此仓库用于跟踪 SDK 更新；开发原生插件或参考 ida-plugin.json 插件清单格式时有用
IDA 9.4 安装包镜像	https://github.com/Yigods/ida94_b1/releases/tag/v9.4-installers	第三方仓库分发的 IDA Pro 9.4 全平台安装包（x64win/armwin/x64linux/armlinux/mac，约 590-680MB，附 SHA256SUMS 校验文件）。注意：非 Hex-Rays 官方分发渠道，官方购买与下载地址为 https://hex-rays.com ，商业使用请确保拥有有效许可证

补充：本机 IDA 安装目录为 C:\Program Files\IDA Professional 9.4（含 idapyswitch.exe，可用于切换 IDAPython 使用的 Python 版本）。