🚀 头模式 IDA MCP 服务器

本项目利用 IDA Pro 的无头模式来分析二进制文件，并通过 MCP 提供一套工具来管理和操作函数、变量等，为二进制文件分析提供了高效的解决方案。

🚀 快速开始

项目依赖

• Python 3.12 或更高版本
• 带有无头支持的 IDA Pro 执行utable (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 无头可执行文件的路径，例如 /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

- 或者通过配置 JSON 文件：

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

效果展示

✨ 主要特性

该项目利用 IDA Pro 的无头模式来分析二进制文件，并通过 MCP 提供一套工具来管理和操作函数、变量等。如果你想直接作为 CLI 应用运行服务器，而不是作为 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 .

💻 使用示例

基础用法

启动服务器：

uv run headless_ida_mcp_server

高级用法

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

• 调试时：

npx -y @modelcontextprotocol/inspector

• 或者通过配置 JSON 文件：

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

📄 致谢

本项目基于以下作品构建：

• 从 ida-pro-mcp 由 mrexodia 改编的工具代码
• 使用 headless-ida 库，作者为 DennyDai