Ida MCP Server Plugin

🚀 IDA Pro MCP サーバープラグイン

IDA Pro MCP サーバープラグインは、モデルコンテキストプロトコル（MCP）インターフェースを通じて、IDA Pro をリモートで照会および制御できるプラグインです。このプラグインにより、AI アシスタント（例えばClaude）が直接 IDA Pro と連携してバイナリ分析タスクを実行できるようになります。

🚀 クイックスタート

IDA Pro MCP サーバープラグインを使用することで、AI アシスタントがバイナリ分析タスクをIDA Pro と連携して実行できます。以下に、基本的な使用手順を説明します。

✨ 主な機能

このサーバーは、AI アシスタントが以下の操作を実行できる一連のツールを提供します。

• 指定したアドレスのバイトデータを取得する
• アセンブリコードを取得する
• 逆コンパイルされた疑似コードを取得する
• 関数名を照会する
• セグメント情報を取得する
• すべての関数をリストする
• クロスリファレンスを検索する
• インポート/エクスポートテーブルを取得する
• エントリポイントを取得する
• 関数を定義/定義解除する
• さまざまなデータ型（dword、word、byte、qword、float、double、string）を取得する
• バイナリファイル内のすべての文字列を取得する
• 指定したアドレスの命令の長さを取得する

📦 インストール

⚠️ 重要提示

このプラグインは、IDA Pro バージョン 9.0+ 用に設計され、テストされています。

1. Python と関連する依存関係をインストールしてください。

pip install -r requirements.txt

2. ida-mcp-server.py ファイルを IDA Pro のプラグインディレクトリにコピーします。
   • Windows：%Programfiles%\IDA Pro 9.0\plugins\
   • Linux：~/.idapro/plugins/
   • macOS：~/Library/Application Support/IDA Pro/plugins/

Claude / VSCode の設定

Claude または VSCode の mcp.json ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "IDAPro": {
      "url": "http://127.0.0.1:3000/sse",
      "type": "sse"
    }
  }
}

💻 使用例

基本的な使用法

1. IDA Pro でバイナリファイルを開きます。
2. プラグインが自動的に読み込まれ、ローカルの MCP サーバー（ポート 3000）が起動します。
3. AI アシスタント（例えばClaude）をこのサーバーに接続します。
4. AI アシスタントを使用してバイナリ分析タスクを実行します。

高度な使用法

IDA Pro MCP サーバーは、以下のツールを提供します。

• get_bytes：指定したアドレスのバイトデータを取得する
• get_disasm：指定したアドレスのアセンブリコードを取得する
• get_decompiled_func：指定したアドレスを含む関数の疑似コードを取得する
• get_function_name：指定したアドレスの関数名を取得する
• get_segments：すべてのセグメント情報を取得する
• get_functions：バイナリファイル内のすべての関数を取得する
• get_xrefs_to：指定したアドレスのすべてのクロスリファレンスを取得する
• get_imports：すべてのインポート関数を取得する
• get_exports：すべてのエクスポート関数を取得する
• get_entry_point：バイナリファイルのエントリポイントを取得する
• make_function：指定したアドレスに関数を作成する
• undefine_function：指定したアドレスの関数定義を解除する
• get_dword_at：指定したアドレスの双ワード（dword）を取得する
• get_word_at：指定したアドレスのワード（word）を取得する
• get_byte_at：指定したアドレスのバイト（byte）を取得する
• get_qword_at：指定したアドレスの8バイト（qword）を取得する
• get_float_at：指定したアドレスの浮動小数点数（float）を取得する
• get_double_at：指定したアドレスの倍精度浮動小数点数（double）を取得する
• get_string_at：指定したアドレスの文字列を取得する
• get_string_list：バイナリファイル内のすべての文字列を取得する
• get_strings：バイナリファイル内のすべての文字列（アドレス付き）を取得する

📚 ドキュメント

ベストプラクティス

バイナリファイルを分析する際には、以下の手順に従うことをお勧めします。

1. エントリポイントを確認する
2. インポートテーブルを分析する
3. 文字列を確認する
4. 重要な API 呼び出しを追跡する
5. 主要な機能ブロックを識別する
6. 制御フローを分析する
7. 悪意のある行為を識別する
8. アルゴリズムと暗号化ルーチンを分析する
9. 分析結果を文書化する
10. 高度な技術を使用する

📄 ライセンス

MIT License

Copyright (c) 2023

このソフトウェアの著作権者は、このソフトウェアと関連するドキュメントファイルのコピーを取得した者（「ソフトウェア」）に対し、以下の条件を満たすことを前提に、無制限に使用、コピー、変更、統合、公開、配布、サブライセンスおよび/または販売する権利を付与します。

1. 配布するすべてのコピーに、すべての著作権表示と許諾表示を含めること。
2. このソフトウェアに関する保証を一切行わないこと。契約、不法行為またはその他の責任の形式に関係なく、作者または著作権者は、このソフトウェアの使用または操作またはその他の関連事項に起因する直接的、間接的、付随的、特殊的、例示的または結果的な損害について一切責任を負わないものとする。