Binaryninja MCP

🚀 Another™ MCP Server for Binary Ninja

Another™ MCP Server is a plugin for Binary Ninja, offering a powerful Web server for each analyzed binary file. It supports multiple functions such as renaming symbols, generating pseudocode and intermediate representation (IR), extracting strings, and finding segments and sections.

🚀 Quick Start

Demo

Introduction

Another™ MCP Server is a plugin for Binary Ninja that provides a powerful web server for each analyzed binary file. The server supports various functions, including renaming symbols, generating pseudocode and intermediate representation (IR), extracting strings, finding segments and sections, etc.

📦 Installation

Server Setup

1. Clone the repository to the Binary Ninja plugins directory:

git clone https://github.com/MCPPhalanx/binaryninja-mcp.git "${env:APPDATA}\Binary Ninja\plugins\MCPPhalanx_binaryninja_mcp"

2. Install the Python environment: Use the uv tool to manage the Python environment:

uv venv
uv sync --dev
binaryninja-mcp install-api

3. Run the server: In the plugin directory, start the server using the following command:

uv run python -m binaryninja_mcp.server

Client Setup

1. Configure the config.json file of the MCP client (e.g., Claude Desktop):

{
  "mcpServers": {
    "binaryninja": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/path/to/binaryninja-mcp",
        "run",
        "binaryninja-mcp",
        "client"
      ]
    }
  }
}

2. SSE client connection: Connect to the SSE (Server-Sent Events) service using the following URL:

http://localhost:7000/sse

✨ Features

Available Tools

Basic Usage

# Example: Rename a function to "main"
import binaryninja as bn
func = bn.current_function()
func.name = "main"

Advanced Usage

# Get the pseudocode of the current function
pseudo_code = bn.current_function().get_pseudo_code()

# Get the intermediate representation (LLVM IR)
ir = bn.current_function().get_llil()

Resources

The MCP server provides the following resource types for each binary file:

• triage_summary: Basic information from the Binary Ninja analysis view
• imports: Dictionary of imported symbols/functions
• exports: Dictionary of exported symbols/functions
• segments: List of memory segments
• sections: List of binary sections
• strings: List of strings extracted from the binary
• functions: List of functions
• data_variables: List of data variables

Development

Environment Setup

1. Clone the repository and install dependencies:

git clone https://github.com/MCPPhalanx/binaryninja-mcp.git
cd binaryninja-mcp
uv install

2. Run the development server:

uv run python -m binaryninja_mcp.server --dev

3. Testing:

pytest
pytest --snapshot-update  # Update test snapshots

Version Control

Use uvx and hatch for version management:

uvx hatch version a       # Increment the beta version
uvx hatch version minor,rc  # Release candidate version
uvx hatch version release   # Release the official version

Publishing

uv publish

📄 License

Apache 2.0