이 저장소에는 Binary Ninja 플러그인, MCP 서버, 그리고 Binary Ninja 기능을 좋아하는 LLM 클라이언트와 원활하게 통합할 수 있는 브리지가 포함되어 있습니다.

특징

• 바이너리 닌자와 MCP 클라이언트 간의 원활한 실시간 통합
• AI 지원을 통한 향상된 역공학 워크플로우
• 모든 MCP 클라이언트(Cline, Claude 데스크톱, Roo Code 등) 지원
• 여러 바이너리 열기 및 활성 대상 자동 전환

예시

CTF 도전 과제 해결

유튜브에서 확장 프로그램을 사용해 CTF 도전을 해결하는 데모 영상을 확인해 보세요.

구성 요소

이 저장소는 두 개의 별도 구성 요소로 구성되어 있습니다:

1. Binary Ninja 플러그인으로, HTTP 엔드포인트를 통해 Binary Ninja의 기능을 노출하는 MCP 서버를 제공합니다. 이 플러그인은 MCP 프로토콜을 구현한 모든 클라이언트와 함께 사용할 수 있습니다.
2. 좋아하는 MCP 클라이언트를 바이너리 닌자 MCP 서버에 연결하는 별도의 MCP 브리지 구성 요소.

선수 조건

• 바이너리 닌자
• 파이썬 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",