MCP(Model Context Protocol)を話すヘッドレスBinary Ninjaサーバーで、AIエージェントにGUIなしで詳細なリバースエンジニアリングワークフロー(ディスアセンブル、IL、パッチ、型、xrefなど)に完全アクセスを提供します。

エージェントランタイムと同じDockerコンテナ内で動作するよう設計されています。サイドカーや追加サービスはありません。

このプロジェクト全体—コード、テスト、ドキュメント—100%バイブコードです。

なぜ

既存のBinary Ninja MCPサーバーはGUIに縛られているか、限られたツールサーフェスしか露出していません。このサーバーはヘッドレス専用で、サンドボックス化されたVM/コンテナ環境におけるエージェント駆動のワークフロー向けに設計されています。エージェントは分析システムを完全に制御し、リバースエンジニアリングの大部分を自動化しながら、あなたは対話的に議論しプロセスをコントロールします。

目標は、エージェントが分析を検査、洗練、拡張できるインターフェースです。タイプ、シンボル、メタデータの更新、分析データベースの段階的改善、パッチ適用や安全な解除・再実行の反復、ワークフローにカスタムスクリプトが必要な場合の実行などが可能になります。

特徴

Binary Ninja Headless MCP

A headless Binary Ninja server that speaks MCP (Model Context Protocol), giving AI agents full access to deep reverse-engineering workflows — disassembly, IL, patching, types, xrefs, and more — without a GUI.

Designed to run in the same Docker container as the agent runtime. No sidecars, no extra services.

This entire project—code, tests, and documentation—is 100% vibe coded.

Why

Existing Binary Ninja MCP servers are either GUI-bound or expose a limited tool surface. This server is headless-only and designed for agent-driven workflows in sandboxed VM/container environments: the agent gets full control over the analysis system, automating large parts of reverse engineering while you interactively discuss and steer the process.

The goal is an interface where agents can inspect, refine, and extend an analysis over time — updating types, symbols, and metadata, improving the analysis database incrementally, applying patches and iterating safely with undo/redo, and running custom scripts when a workflow needs something bespoke.

Features

• 181 tools across 36 feature groups: analysis, disassembly, IL, patching, undo/redo, types, workflows, memory, search, xrefs, scripting, and more.
• Read-only by default with safe mutation workflows (undo/redo, transactions).
• Scripting access via binja.eval and binja.call for anything the tool catalog doesn’t cover.
• Stdio and TCP transports.
• Complete command-line client (binja_cli / binja-cli) with schema-derived flags, JSON batches, offline discovery, and managed persistent servers.
• Zero runtime dependencies beyond Binary Ninja itself.
• Fake backend mode for CI and development without a Binary Ninja license.

Prerequisites

• Python 3.11+
• A Binary Ninja installation with a headless-capable license and the binaryninja Python module importable in your runtime (for real analysis)
• For CI/development without Binary Ninja, use fake backend mode

Installation

git clone https://github.com/mrphrazer/binary-ninja-headless-mcp.git
cd binary-ninja-headless-mcp
pip install .

Or install directly from the repo root without cloning:

pip install git+https://github.com/mrphrazer/binary-ninja-headless-mcp.git

Quick Start

Command-line client

The CLI exposes every MCP tool through the same backend. Its usage follows Ghidra’s ghidra_cli. See the complete CLI guide and generated tool reference for arguments, defaults, sessions, batches, scripting, output, and troubleshooting.

binja_cli list --names-only             # Works without Binary Ninja
binja_cli describe session.open
binja_cli server start                  # Requires licensed Binary Ninja
SID=$(binja_cli --field session_id call session.open --path /bin/ls)
binja_cli --session-id "$SID" call binary.functions --limit 5