Headless IDA MCP Server

謝辞

このプロジェクトは、以下の作業に基づいて構築されています。

• ツールコードは mrexodia のida-pro-mcpから改変しました
• DennyDaiのheadless-idaライブラリを利用する

ヘッドレスIDA MCPサーバー

IDA プラグインを対話的に実行するのではなく、サーバーを CLI アプリとして直接実行する場合は、それを選択できます。

プロジェクトの説明

このプロジェクトは、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"] } } }