Binary Ninja MCP

Binary Ninja MCP is a plugin and server that enables seamless integration between Binary Ninja and LLM clients, enhancing the reverse - engineering workflow by providing binary analysis functions through the MCP protocol.

Developer tools Security #Reverse Engineering #AI Integration #Binary Analysis #Automation Tools .Python

rating : 2.5 points

downloads : 7.5K

update time : 2025-04-28

Open Site

What is the Binary Ninja MCP Server?

The Binary Ninja MCP Server is a plugin that exposes the functionality of Binary Ninja through HTTP endpoints, supporting real - time interaction with other MCP clients (such as Claude Desktop). It helps users generate analysis reports, rename functions, search for functions, etc.

How to use the Binary Ninja MCP Server?

After installing the plugin, start the MCP Server, and then configure the connection in an MCP - protocol - supported client (such as Claude Desktop) to start using it.

Applicable Scenarios

It is suitable for developers, reverse engineers, or security researchers who need to efficiently disassemble and analyze binary files.

Main Features

Get Binary Status

Get the current status of the loaded binary file.

List All Function Names

List all function names in the program.

Rename Function

Rename an existing function to a new user - defined name.

Decompile Function

Decompile a specific function and return C - language code.

Advantages

Seamlessly integrate with the powerful functions of Binary Ninja.

Support multiple advanced functions, such as decompilation and comment management.

Improve the efficiency of reverse engineering and reduce the time for manual operations.

Limitations

Need to be familiar with the basic operations of Binary Ninja.

May require additional configuration steps (such as virtual environment setup).

How to Use

Install the Plugin

Install the 'MCP Server' plugin in Binary Ninja.

Start the MCP Server

Open the plugin menu and select 'Start MCP Server'.

Configure the MCP Client

Add the connection of the Binary Ninja MCP Server in an MCP - supported client.

Usage Examples

Generate an Analysis Report

Run an analysis task on the current binary file and generate a report.

Rename a Function

Rename an existing function to a more descriptive name.

Frequently Asked Questions

Does the Binary Ninja MCP Server support other MCP clients?

Why do I need to configure a virtual environment?

Related Resources

Official Documentation

The official documentation of Binary Ninja.

GitHub Project

The code repository for the Binary Ninja MCP project.

🚀 Binary Ninja MCP

This repository contains a Binary Ninja plugin, an MCP server, and a bridge that seamlessly integrates Binary Ninja's capabilities with your favorite LLM client.

✨ Features

Integrate Binary Ninja with MCP clients in real-time online.
Enhance the decompilation workflow with AI-assisted features.
Primarily support Claude Desktop as the MCP client, but can be extended to other integrations.

💻 Usage Examples

Generate a Binary Analysis Report

Rename a Function

📦 Components

This repository contains two independent components:

A Binary Ninja plugin that provides an MCP server, exposing Binary Ninja's capabilities through HTTP endpoints. This can be used with any client that implements the MCP protocol.
A separate MCP bridge component that connects your preferred MCP client to the Binary Ninja MCP server. Although Claude Desktop is the primary integration path, the MCP server can also be used with other clients.

📚 Supported Integrations

The following table details the currently supported integration features with Binary Ninja.

Property	Details
`get_binary_status`	Get the current status of the loaded binary file.
`list_classes`	List all namespace/class names in the program.
`list_data_items`	List all defined data labels and their values.
`list_exports`	List all exported functions/symbols.
`list_imports`	List all imported symbols in the program.
`list_methods`	List all function names in the program.
`list_namespaces`	List all non-global namespaces.
`list_segments`	List all memory segments of the program.
`rename_data`	Rename the data label at the specified address.
`rename_function`	Rename a function from its current name to a new user-defined name.
`search_functions_by_name`	Search for functions whose names contain a given substring.
`decompile_function`	Decompile a specific function by name or address and return the decompiled C code.
`set_comment`	Set a comment at the specified address.
`set_function_comment`	Set a comment for a function.
`get_comment`	Get the comment at the specified address.
`get_function_comment`	Get the comment for a function.
`delete_comment`	Delete the comment at the specified address.
`delete_function_comment`	Delete the comment for a function.
`get_assembly_function`	Get the assembly representation of a function by name or address.

📦 Installation

Binary Ninja Plugin

You can install the plugin through Binary Ninja's plugin manager (Plugins > Manage Plugins).

To manually configure the plugin, copy this repository to the Binary Ninja plugins folder.

Claude Desktop Bridge (Optional)

This part is only required if you want to use Claude Desktop as the MCP client. Make sure your virtual environment is properly configured:

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

Automated Script for Setting Up Claude Desktop

You may need to run the following command to install dependencies:

pip install pyinstaller requests

📖 Usage Instructions

After Installation

Launch Claude Desktop.
Open the binary file to be analyzed in Binary Ninja.
In Claude Desktop, navigate to View > Extensions > Binary Ninja MCP Bridge.

🔧 Development

The project structure is as follows:

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