Id Assist MCP

IDAssistMCP

用于的独立MCP（模型上下文协议）服务器插件 IDA Pro 9.x 这将IDA的分析功能暴露给像Claude Desktop这样的LLM客户端。

Screenshot

特性

• 41个MCP工具 涵盖二进制分析、反编译、交叉引用、符号管理、类型系统、导航、修补、导出等
• 6个综合工具 和 action/format/direction 注释、变量、类型、外部参照、书签和代码的参数
• 8 MCP资源 用于可浏览的二进制元数据（分类、函数、导入、导出、字符串、信息、段、节）
• 7个引导提示 用于常见的逆向工程工作流程（功能分析、漏洞识别、文档、数据流跟踪、功能比较、结构恢复、网络协议分析）
• SSE和流式HTTP传输 通过Hypercorn ASGI服务器
• 线程安全的IDB修改 通过 execute_on_main_thread() 包装器
• LRU分析缓存 用于反编译等昂贵的操作
• 异步任务管理器 用于长时间运行的操作
• Pydantic配置 具有环境变量支持(IDASSISTMCP_ 前缀）

安装

先决条件

• IDA Pro 9.x与Python 3.10+
• Hex-Rays反编译器（可选，用于反编译工具）

选项1:IDA插件管理器（推荐）

hcli plugin install idassistmcp

这会自动安装插件及其Python依赖项。

选项2：手动安装（从释放tarball开始）

从下载最新版本的zip 并将其解压缩到IDA插件目录中：

Linux/macOS：

unzip IDAssistMCP-*.zip -d ~/.idapro/plugins/

窗户： 将拉链拉入 %APPDATA%\Hex-Rays\IDA Pro\plugins\.

然后使用安装依赖项 IDA捆绑的Python （不是你的Python系统）：

Linux/macOS：

/python3/bin/pip3 install -r ~/.idapro/plugins/IDAssistMCP/requirements.txt

窗户：

"\python3\python.exe" -m pip install -r "%APPDATA%\Hex-Rays\IDA Pro\plugins\IDAssistMCP\requirements.txt"

替换 ` 使用IDA Pro安装路径。 **提示：** 您还可以使用 IDAUSR` 环境变量，用于指定自定义插件目录。

用法

启动服务器

1. 在IDA Pro中打开二进制文件
2. 按 Ctrl+Shift+M 或前往 编辑>插件>IDAssistMCP
3. MCP服务器URL将打印到IDA的输出窗口
4. 再次按Ctrl+Shift+M停止服务器

Claude桌面配置

添加到您的Claude桌面 claude_desktop_config.json:

{
  "mcpServers": {
    "idassistmcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

环境变量

通过环境变量进行配置 IDASSISTMCP_ 前缀：

工具参考

二进制管理（2）

代码分析（4）

交叉引用（1个合并）

评论（1条合并）

变量（1个合并变量）

类型（2--1合并+1独立）

功能发现（5）

符号管理（2）

二进制信息（5）

数据分析（6）

修补（3）

导航（4）

任务管理（4）

项目结构

IDAssistMCP/
├── idassistmcp_plugin.py              # IDA plugin_t entry point
├── requirements.txt
├── README.md
└── src/
    └── idassist_mcp/
        ├── __init__.py
        ├── server.py                  # FastMCP server + transport
        ├── context.py                 # Single-binary IDA context
        ├── tools.py                   # 41 MCP tools (IDA API)
        ├── resources.py               # 8 MCP resources
        ├── prompts.py                 # 7 guided workflow prompts
        ├── config.py                  # Pydantic settings
        ├── cache.py                   # LRU analysis cache
        ├── tasks.py                   # Async task manager
        ├── logging.py                 # IDA logging wrapper
        ├── utils.py                   # IDA-specific utilities
        └── ui/
            └── tool_registry.py       # Tool catalog for UI

许可证

有关详细信息，请参阅LICENSE文件。