Skip to content
KitploitKITPLOIT
ツールエクスプロイトブログ
Log in
提出
ツールエクスプロイトブログ
提出

ハッキング、侵入テスト、サイバーセキュリティツールをあなたのセキュリティアーセナルに!

Kitploitはハッキング、サイバーセキュリティ、ペネトレーションテストのツールディレクトリです。最新のプロジェクトアップデートを見つけて、脆弱性の発見、システム分析、テストの自動化、セキュリティの強化を行いましょう。

フィードお問い合わせプライバシー© 2026 Kitploit

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
ida-cli — idalibを活用した、AI支援バイナリ解析用のヘッドレスIDA Pro MCPサーバー | Kitploit
ツール/GitHubGitHub/cpkt9762/ida-cli
リバースエンジニアリングバイナリ解析AI支援リバースエンジニアリング
GitHubcpkt9762/ida-cli

ida-cli

idalibを活用した、AI支援バイナリ解析用のヘッドレスIDA Pro MCPサーバー

リポジトリを見る
34814724日前Kitploit レビュー済み
共有

ida-cli

macOS および Linux 上でのバイナリ解析のためのヘッドレス IDA CLI とスキルファーストのツールキット。ida-cli はランタイムバックエンドを自動選択し、必要に応じてローカルサーバーを自動起動し、フラットな CLI、stdio MCP トランスポート、Streamable HTTP MCP トランスポートとして同じサーフェスを公開します。

中文说明

2つのユーザー向けエントリーポイント

  • ローカルの ida-cli バイナリ(クライアントとサービスを1つの実行ファイルに統合)
  • エージェント環境向けのインストール可能な ida-cli スキル(skill/SKILL.md)

基盤となるワーカー / ルーターサービス層は CLI によって自動的に起動・停止されます。長期間稼働し外部からアドレス指定可能なサービスが実際に必要な場合にのみ、serve / serve-http を明示的に実行する必要があります。

サポートマトリクス

ホストプラットフォーム

  • サポート: macOS、Linux
  • 非サポート: Windows

IDA ランタイムポリシー

ランタイム要件: IDA 9.4/9.5 および Python >=3.11。すべてのデータベース操作は、専用に固定された Nexus 0.13.4 / Domain 0.5.1 環境を使用します。依存関係の不足やパッチの不一致は明示的に失敗します。Rust ビルドには IDA SDK は不要です。

現在の機能

サポート対象の IDA 9.x ランタイム上で、ida-cli は以下を実行できます:

  • 生の PE / ELF / Mach-O バイナリを開き、キャッシュされた .i64 データベースを再利用する
  • 関数の一覧表示と解決、アドレスまたは名前による逆アセンブル、Hex-Rays によるデコンパイル
  • セグメント、文字列、インポート、エクスポート、エントリーポイント、グローバルシンボルのクエリ
  • アドレス ↔ セグメント / 関数 / シンボルコンテキストの解決
  • バイト / 文字列 / 整数の読み取り、read_* および convert_number ヘルパーの適用
  • アドレスへの / からの xref のクエリ(文字列や構造体フィールドへの xref を含む)
  • コールグラフ、ベーシックブロック、制御フローパスの構築
  • テキスト、即値、バイト、命令、オペランド、擬似コードの検索
  • 型の宣言 / 適用、シンボルとローカルの名前変更、コメントの設定
  • 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 インストール (オプション)

スキルを経由せずにスタンドアロン 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 ファイルに追加します。
  • インストーラーは専用の Python 環境を作成し、4 つのパッチすべて、依存関係のハッシュ、インストール済みモジュールのハッシュを検証します。
  • macOS では、インストール時に /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

CLI を使用する

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 を参照してください。

ビルド要件

  • Rust 1.87+
  • macOS または Linux ホスト
  • IDADIR 経由の IDA インストール(ランタイムサポートは IDA 9.4 から)

ランタイムに関する注意

Nexus

ランチャーは専用の Python 環境を特定します。ソースビルドでは IDA_NEXUS_PYTHON を設定できます。オフラインの sBPF/DSC 準備では引き続き sbx/idat を使用し、通常のクエリ、編集、データベースセッションでは Nexus を使用します。ロールバックでは固定の N0 実行ファイルと、別のリカバリディレクトリにある閉じた移行前バックアップを使用します。実際の環境のインストールや切り替えには明示的な承認が必要です。

キャッシュとローカルランタイムパス

  • データベースキャッシュ: ~/.ida/idb/
  • ログ: ~/.ida/logs/server.log
  • サーバー Unix ソケット: ~/.ida/server.sock
  • サーバー PID ファイル: ~/.ida/server.pid
  • CLI ディスカバリファイル(フラット CLI を稼働中のソケットにマッピング): /tmp/ida-cli.socket
  • 大規模 JSON レスポンスキャッシュ: /tmp/ida-cli-out/

CI とリリース

GitHub Actions はホストされたランナー上で、オープンソースの HexRaysSA/ida-sdk に対してツリーをコンパイルおよびテストするため、CI は特定のプライベートなマシン構成に依存しません。

現在のワークフローの動作:

  • master へのプッシュとプルリクエストで検証を実行
  • v0.9.3 のようなタグ付きプッシュで Linux および macOS 向けのリリースアーカイブをビルド
  • リリースには install.sh とプラットフォーム別アーカイブを添付

リリースバイナリには IDA へのリンクはありません。インストーラーは固定された 4 パッチ適用済みの Nexus Python 環境を作成し、直接特定します。

ドキュメント

  • docs/BUILDING.md — ソースからのビルド
  • docs/ARCHITECTURE.md — ルーター、バックエンド、フェデレーション
  • docs/TRANSPORTS.md — stdio、ストリーミング可能な HTTP、マルチ IDB
  • docs/TOOLS.md — 生成されたツールカタログ
  • docs/TESTING.md — 統合テストとユニットテスト
  • skill/SKILL.md — スキルのブートストラップと使用ポリシー
  • skill/references/cli-tool-reference.md — CLI の全機能

ライセンス

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 を使用してください。これらは独立した制限であり、ワーカー数の直接的な代替ではありません。

ツールをダウンロード

人気

すべて見る →

コミュニティで最も使われているツールを見つけましょう。

まだ人気データがありません。

すべてのツールを探索

ツールコレクションを閲覧

すべてのツールを見る →