Ida Pro MCP Multiple

🚀 IDA MCP サーバー使用説明

このサーバーは、複数のファイルと複数のセッションを並行して分析することができます。必ず覚えておいてください！MCPに接続した後に取得できるツールの数は77個です！

✨ 主な機能

• 多ファイル、多セッションの並行分析をサポート
• 77個の利用可能なツールを提供

📦 インストール

サポートされるプラットフォーム

• ✅ Windows (10/11)
• ✅ macOS (12+)
• ✅ Linux (Ubuntu 20.04+, Debian 11+)

環境要件

インストール手順

Windows

# uv をインストール
pip install uv

# プロジェクトディレクトリに移動
cd ida-pro-mcp

# 依存関係をインストール
uv sync

macOS

# 方法1：公式スクリプトを使用して uv をインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# 方法2：Homebrew を使用
brew install uv

# プロジェクトディレクトリに移動
cd ida-pro-mcp

# 依存関係をインストール
uv sync

Linux

# 公式スクリプトを使用して uv をインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# プロジェクトディレクトリに移動
cd ida-pro-mcp

# 依存関係をインストール
uv sync

設定ファイル（推奨）

ルートディレクトリの config.toml を編集します。相対パスはこのファイルを基準に解決されます。

port = 8746                  # MCP メインポート
base_session_port = 10000    # セッションの開始ポート
analyze_dir = "analyze"      # 事前に読み込む PE/ELF/MachO ディレクトリ
ida_dir = ""                 # オプション、IDA のインストールパス；空の場合は環境変数 IDADIR を使用
uv = "uv"                    # uv 実行可能ファイル
skip_port_check = false      # ポートチェックをスキップ
no_preload = false           # ファイルを事前に読み込まず、空で起動
mcp_dir = "ida-pro-mcp"      # ida-pro-mcp プロジェクトのパス

各プラットフォームの IDA パス設定例

# Windows
ida_dir = "C:/Program Files/IDA Pro 9.2"

# macOS
ida_dir = "/Applications/IDA Pro 9.2/ida.app/Contents/MacOS"

# Linux
ida_dir = "/opt/ida-9.2"

上書きの優先順位：CLI パラメータ > config.toml > 組み込みのデフォルト

💻 使用例

基本的な使用法

方法1：クロスプラットフォームのワンクリック起動（推奨）

config.toml の設定に基づいて、analyze/ 以下のバイナリファイルを自動的にスキャンして起動します。

# Windows / macOS / Linux 共通
python start.py

カスタムパラメータ

# Windows
python start.py --port 9000 --base-session-port 12000 --analyze-dir ./analyze --ida-dir "C:/Program Files/IDA Pro 9.2"

# macOS（パス内のスペースはエスケープまたは引用符で囲む必要があります）
python start.py --port 9000 --ida-dir "/Applications/IDA Pro 9.2/ida.app/Contents/MacOS"

# Linux
python start.py --port 9000 --ida-dir "/opt/ida-9.2"

# ポートチェックをスキップ（ポートが使用中でも起動する）
python start.py --skip-port-check

# 空で起動（ファイルを事前に読み込まず、手動で session_create を使用するのに適しています）
python start.py --no-preload

パラメータの説明

方法2：手動でセッションを作成

1. python start.py --no-preload を実行して空のサーバーを起動します。
2. MCP を使用して session_create を呼び出して分析セッションを作成します。

高度な使用法

セッションを作成して分析する

1. session_list - すべてのセッションを表示
2. session_switch - 目的のセッションに切り替える
3. lookup_funcs - main 関数を検索する
4. decompile - main 関数を逆コンパイルする

パラメータの例

// 関数を検索する
{"name": "lookup_funcs", "arguments": {"queries": "main"}}

// 逆コンパイルする
{"name": "decompile", "arguments": {"addrs": ["0x140001440"]}}

// 関数を一覧表示する
{"name": "list_funcs", "arguments": {"queries": {"count": 10, "offset": 0}}}

📚 ドキュメント

MCP 設定

Claude Desktop

設定ファイルの場所：

設定内容：

{
  "mcpServers": {
    "ida-mcp": {
      "transport": {
        "type": "http",
        "url": "http://127.0.0.1:8746/mcp"
      }
    }
  }
}

Cherry Studio

{
  "mcpServers": {
    "ida-mcp": {
      "name": "IDA MCP サーバー",
      "baseUrl": "http://127.0.0.1:8746/mcp",
      "type": "http"
    }
  }
}

利用可能なツール

セッション管理 (6 個)

分析ツール (71 個)

詳細なツールリストは AVAILABLE_TOOLS.md を参照してください。

🔧 技術詳細

📄 ライセンス

このプロジェクトは MIT ライセンスの下でオープンソース化されています。

🐞 トラブルシューティング

ポートが使用中

Windows

# ポートの使用状況を確認
netstat -ano | findstr ":8746"

# プロセスを終了
taskkill /F /PID <プロセスID>

macOS / Linux

# ポートの使用状況を確認
lsof -i :8746

# プロセスを終了
kill -9 <PID>

# または1つのコマンドで実行
lsof -ti :8746 | xargs kill -9

IDB ファイルがロックされている

analyze/ フォルダ内の .id0, .id1, .id2, .i64 などのファイルを削除し、再度分析を行ってください。

セッションの作成に失敗した

1. IDA のパスが正しいか確認してください。
2. IDA のバージョンが 9.2 以上であることを確認してください。
3. サーバーのログ出力を確認してください。
4. Python のバージョンが 3.11 以上であることを確認してください。

macOS 固有の問題

# 権限の問題が発生した場合
chmod +x start.py

# uv コマンドが見つからない場合
# 方法1：PATH に追加
export PATH="$HOME/.cargo/bin:$PATH"

# 方法2：完全なパスを使用
~/Downloads/ida-pro-mcp/idb/python.exe -m uv sync

Linux 固有の問題

# 依存関係が不足している場合
sudo apt install python3-dev build-essential

# Python が見つからない問題が発生した場合
which python3
python3 --version

📁 ディレクトリ構造

IDA-MCP-Release/
├── analyze/               # 分析対象のバイナリファイルを配置
│   ├── *.exe             # Windows PE ファイル
│   ├── *.elf / *_elf     # Linux ELF ファイル
│   └── *.bin / *_macho   # macOS MachO ファイル
├── ida-pro-mcp/          # MCP サーバーの核心部分
│   ├── .venv/           # 仮想環境
│   └── src/
├── start.py              # クロスプラットフォームのワンクリック起動スクリプト
├── config.toml           # 設定ファイル
├── AVAILABLE_TOOLS.md    # 完全なツールリスト
└── claude_desktop_config.json

📝 更新履歴

v2.0.0 (2025-12-30)

• ✅ ツールの読み込み問題を修正（現在、77 個のツールが正しく表示されます）
• ✅ セッションプロセスのライフサイクルを修正（blocking モードを使用）
• ✅ 71 個のすべての分析ツールのテストに合格
• ✅ クロスプラットフォームのサポートを追加（Windows/macOS/Linux）
• ✅ エラー処理とログ出力を改善