Headless Ida MCP Server

🚀 頭模式 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