IDA Doc Hint MCP

🚀 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システムのプロパティ > 環境変数で永続的に設定することもできます
     

2. Python環境

   • Python 3.8以上のバージョンがインストールされていることを確認してください

📥 インストール

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 が見つかりません"：上記のように環境変数を設定してください
   • 接続が拒否されました：他のMCPサーバーインスタンスが実行されていないことを確認してください
   • Windowsのみ：このプロジェクトはWindowsシステムでのみテストおよびサポートされていますが、他のオペレーティングシステムではいくつかの調整が必要になる場合があります

📝 備考

• サーバーはidalibを使用しており、IDA Proを開く必要はありません！（IDA 9.0以上のみ）
• MCPサーバーを起動する前に、常にIDA Proが正しく閉じられていることを確認してください
• プラグインやスクリプトの開発では、IDA Proの自動化テストを行うためにMCPサーバーを実行する必要があります
• 現在、このプロジェクトはWindowsシステムのみをサポートしていますが、他のオペレーティングシステムではいくつかの調整が必要になる場合があります
• これは簡単な実装ですが、私のテストには有効でした。これにより、LLMがIDA ProのAPIをよりよく理解し、プラグインやスクリプトの開発を支援することができます

何か問題があれば、sysc4lls@gmai.com までお問い合わせください

📄 ライセンス

MITライセンス

Copyright (c) 2024 IDA Pro MCP ドキュメントとツール