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

特徴

• Binary NinjaとMCPクライアント間のシームレスかつリアルタイムな統合
• AI支援による強化されたリバースエンジニアリングワークフロー
• すべてのMCPクライアント(Cline、Claude Desktop、Roo Codeなど)へのサポート
• 複数のバイナリを開き、アクティブターゲットを自動的に切り替える

例

CTFチャレンジの解決

YouTubeのこの拡張機能を使ってCTFチャレンジを解くデモ動画をチェックしてみてください。

構成要素

このリポジトリには2つの独立したコンポーネントが含まれています:

1. Binary Ninjaプラグインで、Binary Ninjaの機能をHTTPエンドポイントを通じて公開するMCPサーバーを提供します。これはMCPプロトコルを実装した任意のクライアントで使用できます。
2. お気に入りのMCPクライアントをBinary Ninja MCPサーバーに接続する別のMCPブリッジコンポーネント。

前提条件

• バイナリーニンジャ
• Python 3.12+
• MCPクライアント(自動セットアップ対応のものは以下に記載)

設置

MCPクライアント

Binary Ninja MCPをインストールする前に、必ずMCPクライアントをインストールしてください。そうすればMCPクライアントが自動設定されます。

Binary Ninja MCP

This repository contains a Binary Ninja plugin, MCP server, and bridge that enables seamless integration of Binary Ninja’s capabilities with your favorite LLM client.

Features

• Seamless, real-time integration between Binary Ninja and MCP clients
• Enhanced reverse engineering workflow with AI assistance
• Support for every MCP client (Cline, Claude desktop, Roo Code, etc.)
• Open multiple binaries and switch the active target automatically

Examples

Solving a CTF Challenge

Check out this demo video on YouTube that uses the extension to solve a CTF challenge.

Components

This repository contains two separate components:

1. A Binary Ninja plugin that provides an MCP server that exposes Binary Ninja’s capabilities through HTTP endpoints. This can be used with any client that implements the MCP protocol.
2. A separate MCP bridge component that connects your favorite MCP client to the Binary Ninja MCP server.

Prerequisites

• Binary Ninja
• Python 3.12+
• MCP client (those with auto-setup support are listed below)

Installation

MCP Client

Please install the MCP client before you install Binary Ninja MCP so that the MCP clients can be auto-setup. We currently support auto-setup for these MCP clients:

1. Cline (recommended)
2. Roo Code
3. Claude Desktop (recommended)
4. Cursor
5. Windsurf
6. Claude Code
7. LM Studio

Extension Installation

After the MCP client is installed, you can install the MCP server using the Binary Ninja Plugin Manager or manually. Both methods support auto-setup of MCP clients.

If your MCP client is not set, you should install it first then try to reinstall the extension.

Binary Ninja Plugin Manager

You may install the extension through Binary Ninja’s Plugin Manager (Plugins > Manage Plugins).

Manual Install

To manually install the extension, this repository can be copied into the Binary Ninja plugins folder.

[Optional] Manual Setup of the MCP Client

You do NOT need to set this up manually if you use a supported MCP client and follow the installation steps before.

You can also manage MCP client entries from the command line:

python scripts/mcp_client_installer.py --install    # auto setup supported MCP clients
python scripts/mcp_client_installer.py --uninstall  # remove entries and delete `.mcp_auto_setup_done`
python scripts/mcp_client_installer.py --config     # print a generic JSON config snippet

Using npm package (Recommended)

The recommended way to set up the MCP client is using the official npm package:

npx -y binary-ninja-mcp

For MCP clients, use this configuration:

{
  "mcpServers": {
    "binary-ninja-mcp": {
      "command": "npx",