致谢

本项目基于以下工作：

• 工具代码改编自 mrexodia 的 ida-pro-mcp
• 使用了 DennyDai 的 headless-ida 库

无界面 IDA MCP 服务器

如果你想直接作为命令行应用程序运行服务器，而不是作为一个交互式的 IDA 插件，你可以选择这样做。

项目描述

该项目使用 IDA Pro 的无界面模式来分析二进制文件，并通过 MCP 提供一系列工具来管理和操作函数、变量等。

预备条件

• Python 3.12 或更高版本
• 带有无界面支持的 IDA Pro (idat) https://github.com/DennyDai/headless-ida

安装

1. 克隆项目到本地：

   git clone https://github.com/cnitlrt/headless-ida-mcp-server.git 
   cd headless-ida-mcp-server
   

2. 安装依赖项：

   uv python install 3.12
   uv venv --python  3.12
   uv pip install -e .
   

配置

1. 复制示例环境文件：

   cp .env_example .env
   

2. 在 .env 文件中配置以下环境变量：

   • IDA_PATH: IDA Pro 的无界面可执行文件路径 (idat)，例如：/home/ubuntu/idapro/idat
   • PORT: MCP 服务器的端口号，例如：8888
   • HOST: MCP 服务器的主机地址，例如：127.0.0.1
   • TRANSPORT: MCP 传输模式 (sse 或 stdio)

使用方法

1. 启动服务器：

   uv run headless_ida_mcp_server
   

2. 使用 MCP 客户端连接到服务器：

   调试它：

   npx -y @modelcontextprotocol/inspector
   

   或者

   {
   "mcpServers": {
      "ida": {
         "command": "/path/to/uv",
         "args": ["--directory","path/to/headless-ida-mcp-server","run","headless_ida_mcp_server"]
      }
   }
   }