IDA Pro MCP Documentation and Utilities

IDA Pro MCP ドキュメントとユーティリティ

このプロジェクトは、MCP（マシンコードプロセッサー）を通じて IDA Pro を利用するためのドキュメントとユーティリティを提供します。

このプロジェクトは、MCP の使い方を学ぶために個人的に楽しみながら作成したもので、実際の用途を想定したものではありません。

⚠️ システム要件

• IDA Pro のインストールが必要です
• Python 3.8 以降

🔧 前提条件

1. IDA Pro のインストール
   • IDA Pro が正常にインストールされていることを確認してください
   • IDADIR 環境変数に IDA Pro のインストールディレクトリを設定してください

     # 例（PowerShell）：
     $env:IDADIR = "C:\Program Files\IDA Pro"
     # または、Windows のシステムのプロパティ > 環境変数から恒久的に設定してください
     

📥 インストール

1. Poetry のインストール（まだインストールされていない場合）

   (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
   

   または

   pipx install poetry
   

2. 依存関係のインストール

   poetry install
   

🚀 MCP サーバーのセットアップ

1. Cursor の MCP 設定をセットアップ

   "ida-pro-doc": {
      "command": "<venv_python_path>/python.exe",
      "args": [
        "<path_to_project>/server.py"
      ]
    }
   

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

1. MCP サーバーで問題が発生した場合：

   • IDADIR 環境変数が正しく設定されていることを確認してください
   • IDA Pro が正常に動作していることを確認してください
   • ウイルス対策ソフトウェアが接続をブロックしていないか確認してください

2. よくある問題：

   • 「IDADIR not found」：前提条件に記載されているとおりに環境変数を設定してください
   • 接続が拒否される：MCP サーバーの別のインスタンスが実行されていないことを確認してください
   • Windows のみ：このプロジェクトは Windows システムのみでテストされ、サポートされています
   • Cursor のみ：このプロジェクトは Cursor 内でのみテストされていますが、ほかのソフトウェアでも動作するはずです。

📝 メモ

• サーバーは idalib を使用するため、IDA Pro を起動する必要はありません！（この機能は IDA 9.0 以降でのみサポートされています）
• MCP サーバーを起動する前に、必ず IDA Pro を適切に終了してください
• IDA Pro の自動化スクリプトを動作させるには、MCP サーバーが実行されている必要があります
• 現時点ではこのプロジェクトは Windows 専用です。他のオペレーティングシステムはサポートされていませんが、少し調整すれば動作するはずです
• これは雑でお粗末な実装ですが、私のテストでは動作します。LLM が利用可能な ida-pro の API をより適切に理解できるようにするもので、 ida 向けのプラグインやスクリプトの開発に役立ちます！

ご質問がありましたら、どんなことでも [email protected] までお気軽にご連絡ください。

📄 ライセンス

MIT ライセンス

Copyright (c) 2024 IDA Pro MCP Documentation and Utilities