headless-ida-mcp-server

謝辞

このプロジェクトは、以下の成果を基盤としています。

• ida-pro-mcp のツールコードを mrexodia 氏の成果から応用しています
• DennyDai 氏の headless-ida ライブラリを使用しています

Headless 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"]
      }
   }
   }