Cnitlrt Headless Ida MCP Server

🚀 頭無顯示 IDA MCP 服務器

頭無顯示 IDA MCP 服務器是一個基於 IDA Pro 無頭模式的項目，它藉助多客戶端協議（MCP），為用戶提供遠程分析與管理的功能，極大提升了二進制文件分析的便捷性與效率。

🚀 快速開始

項目描述

該項目運用 IDA Pro 的無頭模式對二進制文件進行分析，並通過 MCP 提供一套工具，用於管理和操作函數、變量等。

先決條件

• Python 3.10 或更高版本
• 帶有無頭支持的 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 venv 
source .venv/bin/activate
uv pip install .

🛠️ 配置步驟

複製示例環境文件

cp .env_example .env

配置環境變量

在 .env 中配置以下環境變量：

• IDA_PATH：IDA Pro 無頭可執行文件路徑（idat），例如 /home/ubuntu/idapro/idat
• BINARY_PATH：分析用的二進制文件路徑，例如 ./test/main
• PORT：MCP 服務器端口，例如 8888
• HOST：MCP 服務器主機地址，例如 127.0.0.1
• TRANSPORT：MCP 傳輸模式（sse 或 stdio）

💻 使用示例

啟動服務器

uv run headless_ida_mcp_server

連接服務器

使用 MCP 客戶端連接到服務器：

npx -y @modelcontextprotocol/inspector

效果展示

📄 致謝

本項目基於以下作品構建：

• 從 ida-pro-mcp 由 mrexodia 改編的工具代碼
• 使用 headless-ida 庫，由 DennyDai 開發