Headless Ida MCP Server

🚀 ヘッドレスモード IDA MCP サーバー

このプロジェクトは、IDA Pro のヘッドレスモードを利用してバイナリファイルを分析し、MCP を通じて関数や変数などの管理と操作を行うツールセットを提供します。

🤝 謝辞

本プロジェクトは以下の作品をベースに構築されています。

• ida - pro - mcp から mrexodia によって改変されたツールコード
• headless - ida ライブラリを使用しています。作者は DennyDai です。

🚀 クイックスタート

このサーバーを 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 のヘッドレス実行可能ファイルのパス。例: /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"]
      }
   }
   }