MCP 服务器

Headless IDA MCP Server

一个服务器，通过 IDA Pro 的无头模式提供远程二进制分析功能，允许用户通过多客户端协议管理和操作函数、变量以及其他二进制元素。

README

致谢

本项目基于以下项目的工作：

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

Headless IDA MCP 服务器

如果您希望直接将服务器作为命令行应用程序运行，而不是以交互方式作为 IDA 插件运行，您可以选择它。

项目描述

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

前提条件

Python 3.12 或更高版本
支持 headless 模式的 IDA Pro (idat) https://github.com/DennyDai/headless-ida

安装

将项目克隆到本地：

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

安装依赖项：

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

配置

复制示例环境变量文件：
```
cp .env_example .env
```
在 .env 中配置以下环境变量：
- IDA_PATH: IDA Pro 的 headless 可执行文件 (idat) 的路径，例如 /home/ubuntu/idapro/idat
- PORT: MCP 服务器的端口号，例如 8888
- HOST: MCP 服务器的主机地址，例如 127.0.0.1
- TRANSPORT: MCP 传输模式 (sse 或 stdio)

使用

启动服务器：
```
uv run headless_ida_mcp_server
```

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

调试它：

npx -y @modelcontextprotocol/inspector

或者

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