Headless IDA MCP Server

致谢

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

• 工具代码改编自 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"] } } }