バイナリ忍者MCP

このリポジトリには、Binary Ninja プラグイン、MCP サーバー、およびお気に入りの LLM クライアントと Binary Ninja の機能をシームレスに統合できるブリッジが含まれています。

特徴

• Binary NinjaとMCPクライアント間のシームレスでリアルタイムな統合

• AI支援によるリバースエンジニアリングワークフローの強化

• MCPクライアントとしてClaude Desktopを主にサポートしていますが、他の統合にも拡張可能です。

Related MCP server: GhidraMCP

例

バイナリ分析レポートの生成

関数名の変更

コンポーネント

このリポジトリには 2 つの個別のコンポーネントが含まれています。

1. Binary Ninjaの機能をHTTPエンドポイント経由で公開するMCPサーバーを提供するBinary Ninjaプラグイン。MCPプロトコルを実装するあらゆるクライアントで使用できます。

2. お気に入りのMCPクライアントをBinary Ninja MCPサーバーに接続する、独立したMCPブリッジコンポーネントです。Claude Desktopが主な統合パスですが、MCPサーバーは他のクライアントでも使用できます。

サポートされている統合

次の表は、現在サポートされている Binary Ninja との統合の詳細を示しています。

前提条件

• バイナリ忍者

• Python 3.12以上

• Claude Desktop （またはお好みの統合）

インストール

バイナリ忍者プラグイン

プラグインは、Binary Ninja のプラグイン マネージャー ( Plugins > Manage Plugins ) からインストールできます。

プラグインを手動で構成するには、このリポジトリを Binary Ninja プラグイン フォルダーにコピーします。

クロード デスクトップ ブリッジ (オプション)

これは、Claude DesktopをMCPクライアントとして使用する場合にのみ必要です。まず、仮想環境が設定されていることを確認してください。

git clone git@github.com:fosdickio/binary_ninja_mcp.git
cd binary_ninja_mcp

python3 -m venv .venv
source .venv/bin/activate   # On macOS/Linux

pip install -r bridge/requirements.txt

自動構成（Mac）

Mac では、次のコマンドを実行してセットアップを自動化できます。

./scripts/setup_claude_desktop.py

手動設定

他のオペレーティング システムの場合、または Claude Desktop 統合を手動で構成する場合:

1. Settings > Developer > Edit Configに移動します

2. 次の構成を追加します。

{
  "mcpServers": {
    "binary_ninja_mcp": {
      "command": "/ABSOLUTE/PATH/TO/binary_ninja_mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/binary_ninja_mcp/bridge/binja_mcp_bridge.py"
      ]
    }
  }
}

注: /ABSOLUTE/PATH/TOプロジェクトディレクトリへの実際の絶対パスに置き換えてください。インストールされた依存関係にアクセスするには、仮想環境の Python インタープリターを使用する必要があります。

使用法

クロードデスクトップ

1. Binary Ninjaを開き、 Binary Ninja MCPプラグインをインストールします。

2. Binary Ninjaを再起動してバイナリファイルを開きます

3. MCP サーバーを起動します ( Plugins > MCP Server > Start MCP Server )

4. Claudeデスクトップを起動

Claude Desktop を開くと、統合が自動的に利用可能になります。

現在開いているバイナリについてClaudeに確認メッセージを送ることができます。プロンプトの例:

• 「現在のバイナリのバイナリ分析レポートを生成します。」

• 「現在のバイナリで関数 X の名前を Y に変更します。」

• 「現在のバイナリ内のすべての関数を一覧表示します。」

• 「ロードされたバイナリのステータスはどうですか？」

その他のMCPクライアント統合

適切な統合レイヤーを実装することにより、ブリッジを他の MCP クライアントと共に使用できます。

発達

プロジェクト構造は次のように構成されます。

binary_ninja_mcp/
├── bridge/                      # MCP client integration
├── plugin/                      # Binary Ninja plugin
├── scripts/
│   └── setup_claude_desktop.py  # Setup script for Claude Desktop

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。