IDA-doc-hint-mcp

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

このプロジェクトは、MCP (マシン コード プロセッサ) を介して IDA Pro を操作するためのドキュメントとユーティリティを提供します。

このプロジェクトは、MCP の使い方を学ぶための私自身の楽しみのためであり、実際の使用を目的としたものではありません。

⚠️ システム要件

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

🔧 前提条件

1. IDA Proのインストール
   • IDA Proが正常にインストールされていることを確認してください
   • IDADIR環境変数をIDA Proのインストールディレクトリを指すように設定します。
     # Example (PowerShell): $env:IDADIR = "C:\Program Files\IDA Pro" # or set it permanently through Windows System Properties > Environment Variables

📥 インストール

1. Poetry をインストールします(まだインストールされていない場合)
   (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
   または
   pipx install poetry
2. 依存関係をインストールする
   poetry install

🚀 MCP サーバーの設定

1. カーソル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 をよりよく理解できるようになり、ida のプラグインとスクリプトの開発に役立ちます。

ご質問がありましたら、お気軽にsysc4lls@gmai.comまでお問い合わせください。

📄 ライセンス

MITライセンス

著作権 (c) 2024 IDA Pro MCP ドキュメントおよびユーティリティ