致谢

该项目建立在以下工作基础之上：

• 工具代码改编自 mrexodia 的ida-pro-mcp

• 利用 DennyDai 的headless-ida库

无头 IDA MCP 服务器

如果您想直接将服务器作为 cli 应用程序运行，而不是以交互方式运行 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"] } } }