ida-pro-mcp-plus

IDA Pro+ MCP

Enhanced IDA Pro MCP Server — 基于上游 ida-pro-mcp 最新版，融合三大项目优势。

特性总览

| 来源 | 特性 | 说明 | |:---|:---|:---| | ida-pro-mcp | 80+ MCP 工具 | 反编译、反汇编、交叉引用、搜索、修改、调试、类型系统等 | | ida-pro-mcp | Headless idalib | 无 GUI 批量分析（--isolated-contexts） | | ida-pro-mcp | 多实例发现 | list_instances / select_instance / open_file | | enhancement | Broker 架构 | HTTP+SSE 中间层，IDA 主动注册，优雅管理多实例 | | IDA-NO-MCP | 批量导出 | 一键导出全部函数/字符串/导入导出表/段信息到文件 |

Claude Code / Cursor ──MCP──► IDA Pro+ MCP Server
                                ├─ 标准模式: 直连 IDA RPC (默认)
                                └─ Broker 模式: HTTP+SSE 多实例管理 (--broker)
                                     ├─ IDA 实例 A (自动注册)
                                     ├─ IDA 实例 B (自动注册)
                                     └─ ...

新增批量导出工具:
  bulk_export      → 全函数反编译/反汇编导出
  export_strings   → 字符串表导出
  export_imports   → 导入/导出表
  export_segments  → 段信息 + 可选 hexdump

安装

前置条件

• Python 3.11+
• uv (推荐) 或 pip
• IDA Pro 8.3+ (推荐 9.0+)

安装步骤

# 克隆
git clone https://github.com/YourUsername/ida-pro-mcp-plus.git
cd ida-pro-mcp-plus

# 安装（含 IDA 插件）
uv run ida-pro-mcp --install

# 或指定客户端
uv run ida-pro-mcp --install claude,cursor

Claude Code 配置

{
  "mcpServers": {
    "ida-pro-mcp-plus": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "/path/to/ida-pro-mcp-plus", "run", "ida-pro-mcp"],
      "env": {}
    }
  }
}

Broker 模式配置

{
  "mcpServers": {
    "ida-pro-mcp-plus": {
      "type": "stdio",
      "command": "uv",
      "args": ["--directory", "/path/to/ida-pro-mcp-plus", "run", "ida-pro-mcp", "--broker"],
      "env": {}
    }
  }
}

使用

标准模式（默认）

与上游 ida-pro-mcp 完全兼容。IDA 中按 Ctrl+Alt+M (Windows/Linux) 或 Ctrl+Option+M (macOS) 启动插件。

# 运行 MCP 服务
uv run ida-pro-mcp

# 指定 IDA 实例
uv run ida-pro-mcp --ida-rpc http://127.0.0.1:13337

# 启用危险操作（调试器等）
uv run ida-pro-mcp --unsafe

Broker 模式（多实例管理）

适合同时打开多个 IDA 窗口的场景。

# 启动 Broker（默认端口 13337）
uv run ida-pro-mcp --broker

# 指定端口
uv run ida-pro-mcp --broker --broker-port 13338

IDA 实例通过插件自动注册到 Broker。使用 MCP 工具切换：

list_instances    → 查看所有已连接的 IDA 实例
select_instance   → 切换当前活动实例

批量导出（新增）

bulk_export       → 导出所有函数到 .c/.asm 文件
export_strings    → 导出字符串表
export_imports    → 导出导入/导出表
export_segments   → 导出段信息（可选 hexdump）

示例：导出整个二进制供 AI 分析

通过 MCP 工具调用：

→ bulk_export(skip_library=true)

结果:
  output_dir: /path/to/binary_export/
  ├── decompile/         # 反编译成功的 .c 文件
  │   ├── 401000.c
  │   ├── 401050.c
  │   └── ...
  ├── disassembly/       # 反编译失败降级的 .asm 文件
  │   ├── 402000.asm
  │   └── ...
  └── function_index.txt # 函数索引

→ export_strings(min_length=6)
→ export_imports()
→ export_segments(include_hexdump=false)

每个导出的函数文件包含元数据头：

/*
 * func-name: main
 * func-address: 0x401000
 * export-type: decompile
 * callers: 0x400e00
 * callees: 0x401100, 0x401200
 */
int __cdecl main(int argc, const char **argv, const char **envp)
{
    ...
}

Headless 模式 (idalib)

# 无 GUI 分析二进制
uv run idalib-mcp /path/to/binary

# 多 agent 隔离上下文
uv run idalib-mcp --isolated-contexts /path/to/binary

工具列表

上游工具（80+）

| 类别 | 工具 | |:---|:---| | 核心 | lookup_funcs, list_funcs, list_globals, imports, list_segments, ... | | 分析 | decompile, disasm, xrefs_to, xrefs_to_field, callees, callgraph, find, find_regex, find_bytes, find_insns, ... | | 内存 | get_bytes, get_int, get_string, get_global_value, patch, put_int, ... | | 类型 | set_type, infer_types, declare_type, read_struct, search_structs, ... | | 修改 | set_comments, rename, patch_asm, define_func, define_code, undefine, ... | | 栈帧 | stack_frame, declare_stack, delete_stack | | 调试 | 20 个调试工具（需 --unsafe） | | Python | py_eval | | 实例 | list_instances, select_instance, open_file |

新增工具

| 工具 | 说明 | |:---|:---| | bulk_export | 全函数反编译/反汇编导出，支持断点续传、库函数过滤、内存清理 | | export_strings | 字符串表导出，支持最小长度过滤 | | export_imports | 导入表 + 导出表 | | export_segments | 段信息 + 可选 hexdump |

架构

┌─────────────────────────────────────────────────────────┐
│                    MCP Clients                          │
│     (Claude Code / Cursor / VS Code / ...)              │
└────────────────┬────────────────────────────────────────┘
                 │ stdio / HTTP
┌────────────────▼────────────────────────────────────────┐
│              IDA Pro+ MCP Server                        │
│  ┌──────────┐  ┌──────────┐  ┌────────────────────┐    │
│  │ 标准模式  │  │ Broker   │  │ 批量导出工具        │    │
│  │ (直连RPC) │  │ (HTTP+   │  │ bulk_export        │    │
│  │          │  │  SSE)    │  │ export_strings     │    │
│  └────┬─────┘  └────┬─────┘  │ export_imports     │    │
│       │              │        │ export_segments    │    │
│       ▼              ▼        └────────────────────┘    │
│  ┌─────────┐  ┌──────────┐                              │
│  │ IDA RPC │  │IDA 注册表 │                              │
│  │ (1实例)  │  │ (N实例)  │                              │
│  └────┬────┘  └───┬──┬───┘                              │
└───────┼───────────┼──┼──────────────────────────────────┘
        │           │  │
        ▼           ▼  ▼
   ┌────────┐  ┌────────┐  ┌────────┐
   │ IDA #1 │  │ IDA #1 │  │ IDA #2 │
   └────────┘  └────────┘  └────────┘

致谢

• mrexodia/ida-pro-mcp — 上游基础，80+ 工具
• QiuChenly/ida-pro-mcp-enhancement — Broker 架构
• P4nda0s/IDA-NO-MCP — 批量导出思路

License

MIT License — 与上游保持一致。