
idalibを活用した、AI支援バイナリ解析用のヘッドレスIDA Pro MCPサーバー
macOS および Linux 上でのバイナリ解析のためのヘッドレス IDA CLI とスキルファーストのツールキット。ida-cli はランタイムバックエンドを自動選択し、必要に応じてローカルサーバーを自動起動し、フラットな CLI、stdio MCP トランスポート、Streamable HTTP MCP トランスポートとして同じサーフェスを公開します。
ida-cli バイナリ(クライアントとサービスを1つの実行ファイルに統合)ida-cli スキル(skill/SKILL.md)基盤となるワーカー / ルーターサービス層は CLI によって自動的に起動・停止されます。長期間稼働し外部からアドレス指定可能なサービスが実際に必要な場合にのみ、serve / serve-http を明示的に実行する必要があります。
ランタイム要件: IDA 9.4/9.5 および Python >=3.11。すべてのデータベース操作は、専用に固定された Nexus 0.13.4 / Domain 0.5.1 環境を使用します。依存関係の不足やパッチの不一致は明示的に失敗します。Rust ビルドには IDA SDK は不要です。
サポート対象の IDA 9.x ランタイム上で、ida-cli は以下を実行できます:
.i64 データベースを再利用するread_* および convert_number ヘルパーの適用run_script による IDAPython スニペットの実行すべてのツールは明示的なケーパビリティエラーを伴う Nexus を使用します。生成されたツール一覧については docs/TOOLS.md を参照してください。
デフォルトのエントリーポイントは ida-cli スキルであり、手動での CLI インストールではありません。
# list the skill exposed by this repository
npx -y skills add https://github.com/cpkt9762/ida-cli --list
# install the ida-cli skill for Codex
npx -y skills add https://github.com/cpkt9762/ida-cli --skill ida-cli --agent codex --yes --global
インストール後、スキルは独自のブートストラップラッパーを同梱します:
~/.agents/skills/ida-cli/scripts/ida-cli.sh --help
~/.agents/skills/ida-cli/scripts/ida-cli.sh probe-runtime
~/.agents/skills/ida-cli/scripts/ida-cli.sh --path /path/to/binary list-functions --limit 20
ida-cli が見つからない場合、ラッパーはコマンドを転送する前にリポジトリのインストーラーを通じてインストールします。
スキルを経由せずにスタンドアロン CLI のみを使用したい場合に限り、これを使用してください。
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --add-path
便利なバリエーション:
# install a specific release
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --tag v0.9.3 --add-path
# build directly from a branch or ref
curl -fsSL https://raw.githubusercontent.com/cpkt9762/ida-cli/master/scripts/install.sh | bash -s -- --ref master --build-from-source --add-path
注意:
~/.local/bin/ida-cli に配置します。--add-path はその bin ディレクトリをシェルの rc ファイルに追加します。/Applications または ~/Applications 配下の最新の数値バージョンの .app が選択され、選択された候補とその他の候補が表示されます。9.10 は 9.9 より新しく、末尾のゼロ要素は等しいとみなされ、同点の場合は正規パスの順序で解決されます。明示的な IDADIR が優先されます。互換性のない選択済みの wheel/ランタイムは明示的に失敗します。候補が見つからない場合、インストールは IDADIR を設定するよう指示して失敗します。IDADIR はそれを上書きします。.app、Contents、ランタイムのパスが受け付けられます。バージョン比較とランタイムチェックを参照してください。git clone https://github.com/cpkt9762/ida-cli.git
cd ida-cli
export IDADIR="/Applications/IDA Professional 9.5.app/Contents/MacOS" # or a Linux install
cargo build --bin ida-cli
./target/debug/ida-cli --help
ida-cli はクライアントファーストです。任意のクライアントサブコマンドは、ランダムなポートにバインドされたローカルの Streamable-HTTP サーバーを自動起動し、検出用に /tmp/ida-cli.socket を書き込みます:
./target/debug/ida-cli --path /path/to/sample.bin list-functions --limit 20
./target/debug/ida-cli --path /path/to/sample.bin decompile --addr 0x140001000
./target/debug/ida-cli --path /path/to/sample.bin raw '{"method":"get_xrefs_to","params":{"address":"0x140001000"}}'
デーモンが現在開いているデータベースと、それらを保持しているクライアントを確認するには、list-idbs(MCP ツール: list_idbs)を実行します。.i64 を再ビルドまたは置き換える前に、たとえば idat を使う前に実行してください。一覧にまだ表示されているデータベースはデーモンによって開かれたまま保持されており、idat は他の場所で開かれているデータベースでは失敗します。応答は {"count": N, "idbs": [...]} です。各エントリには db_handle、入力パスと .i64 パス、それを開いたクライアントの不透明な ID、開かれた時刻、ワーカープロセス、それがアクティブなデータベースかどうか、そしてまだ参照を保持しているクライアントが含まれます。クローズトークンは決して返されません。
./target/debug/ida-cli list-idbs --json
各擬似コード行の背後にあるアドレスを取得するには、decompile に --line-addresses を追加します(MCP および RPC では decompile_function に line_addresses: true)。結果は {"code": ..., "lines": [...]} となり、code は通常のテキスト、各 lines エントリは {"line", "text", "addresses"} です。line は 1 から始まる行番号、text は code のその行、addresses は Hex-Rays がその行にアンカーした ctree アイテムの IDA アドレス(16 進文字列、昇順、重複なし)です。1 つの行が複数の非連続なアドレスにマッピングされることがあり、このリストはその文のすべての命令ではありません。シグネチャとローカル宣言にはアドレスがありません。{、}、else、および空行は、それらを所有するブロックまたは if のアドレス(最も外側の波括弧の場合は関数エントリ)を持つことがあります。このモードでは sub_ のリネームヒントは追加されません。Hex-Rays は非常に大きな関数を呼び出しごとに異なる形で出力することがあるため、同じ応答の code と lines のみを組み合わせて使用してください。Nexus はこのモードをサポートしています。CLI ソケット経由では、大きな応答は他の応答と同様にレスポンスキャッシュに保存されます(IDA_MCP_MAX_INLINE_BYTES)。
{"line": 6, "text": " while ( a1 != 1 )", "addresses": ["0x10000033c", "0x100000340"]}
最初の引数がサービスサブコマンド(serve、serve-http、serve-worker、probe-runtime)であるコマンドは、代わりにサービスモードに入ります:
./target/debug/ida-cli serve # stdio MCP transport
./target/debug/ida-cli serve-http --bind 127.0.0.1:8765
./target/debug/ida-cli probe-runtime
probe-runtime は Nexus の依存関係、パッチ、プロトコルの準備状況を確認し、不一致があれば非ゼロで終了します。
CLI の全機能については skill/references/cli-tool-reference.md を参照してください。
IDADIR 経由の IDA インストール(ランタイムサポートは IDA 9.4 から)ランチャーは専用の Python 環境を特定します。ソースビルドでは IDA_NEXUS_PYTHON を設定できます。オフラインの sBPF/DSC 準備では引き続き sbx/idat を使用し、通常のクエリ、編集、データベースセッションでは Nexus を使用します。ロールバックでは固定の N0 実行ファイルと、別のリカバリディレクトリにある閉じた移行前バックアップを使用します。実際の環境のインストールや切り替えには明示的な承認が必要です。
~/.ida/idb/~/.ida/logs/server.log~/.ida/server.sock~/.ida/server.pid/tmp/ida-cli.socket/tmp/ida-cli-out/GitHub Actions はホストされたランナー上で、オープンソースの HexRaysSA/ida-sdk に対してツリーをコンパイルおよびテストするため、CI は特定のプライベートなマシン構成に依存しません。
現在のワークフローの動作:
master へのプッシュとプルリクエストで検証を実行v0.9.3 のようなタグ付きプッシュで Linux および macOS 向けのリリースアーカイブをビルドinstall.sh とプラットフォーム別アーカイブを添付リリースバイナリには IDA へのリンクはありません。インストーラーは固定された 4 パッチ適用済みの Nexus Python 環境を作成し、直接特定します。
MIT
削除された設定は、CLI デーモンのディスカバリやサーバー起動の前にエラーとなります(空の値であっても): IDA_CLI_NEXUS_DEV、IDA_CLI_WORKER_BACKEND、IDA_CLI_SDK_VERSION、IDA_CLI_MAX_WORKERS、IDA_CLI_MAX_WORKERS_PER_TENANT、IDA_CLI_MAX_PENDING_PER_WORKER、IDA_CLI_MAX_CONCURRENT_SPAWNS。これらの変数を削除してください。Nexus の制限には、該当する IDA_CLI_MAX_PENDING_PER_TENANT、IDA_CLI_NEXUS_RETENTION_CAPACITY、または IDA_CLI_HELPER_CAPACITY を使用してください。これらは独立した制限であり、ワーカー数の直接的な代替ではありません。