Binärer Ninja MCP

Dieses Repository enthält ein Binary Ninja-Plugin, einen MCP-Server und eine Bridge, die eine nahtlose Integration der Funktionen von Binary Ninja in Ihren bevorzugten LLM-Client ermöglicht.

Merkmale

• Nahtlose Echtzeitintegration zwischen Binary Ninja und MCP-Clients

• Verbesserter Reverse-Engineering-Workflow mit KI-Unterstützung

• Primäre Unterstützung für Claude Desktop als MCP-Client, aber erweiterbar für andere Integrationen

Related MCP server: GhidraMCP

Beispiele

Generieren eines Binäranalyseberichts

Umbenennen von Funktionen

Komponenten

Dieses Repository enthält zwei separate Komponenten:

1. Ein Binary Ninja-Plugin, das einen MCP-Server bereitstellt, der die Funktionen von Binary Ninja über HTTP-Endpunkte bereitstellt. Dies kann mit jedem Client verwendet werden, der das MCP-Protokoll implementiert.

2. Eine separate MCP-Bridge-Komponente, die Ihren bevorzugten MCP-Client mit dem Binary Ninja MCP-Server verbindet. Während Claude Desktop der primäre Integrationspfad ist, kann der MCP-Server auch mit anderen Clients verwendet werden.

Unterstützte Integrationen

In der folgenden Tabelle ist aufgeführt, welche Integrationen mit Binary Ninja derzeit unterstützt werden.

Voraussetzungen

• Binärer Ninja

• Python 3.12+

• Claude Desktop (oder Ihre bevorzugte Integration)

Installation

Binary Ninja Plugin

Sie können das Plugin über den Plugin-Manager von Binary Ninja ( Plugins > Manage Plugins ) installieren.

Um das Plugin manuell zu konfigurieren, kann dieses Repository in den Plugin-Ordner von Binary Ninja kopiert werden.

Claude Desktop Bridge (optional)

Dies ist nur erforderlich, wenn Sie Claude Desktop als MCP-Client verwenden möchten. Stellen Sie sicher, dass Sie zuerst Ihre virtuelle Umgebung konfiguriert haben:

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

Automatisierte Konfiguration (Mac)

Auf einem Mac können Sie die Einrichtung automatisieren, indem Sie Folgendes ausführen:

./scripts/setup_claude_desktop.py

Manuelle Konfiguration

Auf anderen Betriebssystemen oder um die Claude Desktop-Integration manuell zu konfigurieren:

1. Navigieren Sie zu Settings > Developer > Edit Config

2. Fügen Sie die folgende Konfiguration hinzu:

{
  "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"
      ]
    }
  }
}

Hinweis: Ersetzen Sie /ABSOLUTE/PATH/TO durch den tatsächlichen absoluten Pfad zu Ihrem Projektverzeichnis. Für den Zugriff auf die installierten Abhängigkeiten muss der Python-Interpreter der virtuellen Umgebung verwendet werden.

Verwendung

Claude Desktop

1. Öffnen Sie Binary Ninja und installieren Sie das Binary Ninja MCP Plugin

2. Starten Sie Binary Ninja neu und öffnen Sie dann eine Binärdatei

3. Starten Sie den MCP-Server ( Plugins > MCP Server > Start MCP Server )

4. Starten Sie Claude Desktop

Die Integration ist automatisch verfügbar, nachdem Sie Claude Desktop geöffnet haben.

Sie können Claude nun nach der aktuell geöffneten Binärdatei fragen. Beispiel-Eingabeaufforderungen:

• "Erstellen Sie einen Binäranalysebericht für die aktuelle Binärdatei."

• "Benennen Sie die Funktion X in der aktuellen Binärdatei in Y um."

• "Listet alle Funktionen in der aktuellen Binärdatei auf."

• „Wie ist der Status der geladenen Binärdatei?“

Andere MCP-Client-Integrationen

Die Bridge kann mit anderen MCP-Clients verwendet werden, indem die entsprechende Integrationsschicht implementiert wird.

Entwicklung

Die Projektstruktur ist wie folgt organisiert:

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

Beitragen

Beiträge sind willkommen. Senden Sie gerne einen Pull Request.