Invoke-RE/binja-lattice-mcp

BinjaLattice is a secure communication protocol for Binary Ninja that enables interaction with external Model Context Protocol (MCP) servers and tools. It provides a structured way to acquire information from Binary Ninja and the ability to modify an active Binary Ninja database over HTTP with a REST API.
## Demo
## Features
Secure Authentication: Token-based authentication system
Encrypted Communication: Optional SSL/TLS encryption
Binary Analysis Context: Export pseudocode, disassembly, variable names, binary information etc.
Binary Modification: Update function names, add comments, rename variables
Token Management: Automatic expiration and renewal of authentication tokens
## Installation
### Windows (Automated)
Run the PowerShell installer for a one-shot setup:
powershell
.\scripts\install_windows.ps1
This will:
Install the plugin to %APPDATA%\Binary Ninja\plugins\
Create a Python virtual environment (.venv)
Install all dependencies
Output a ready-to-use MCP configuration
### Manual Installation (All Platforms)
1. Copy plugin/lattice_server_plugin.py and plugin/lattice_config.ini to your Binary Ninja plugins directory:
Linux: ~/.binaryninja/plugins/
macOS: ~/Library/Application Support/Binary Ninja/plugins/
Windows: %APPDATA%\Binary Ninja\plugins\
2. Generate a secure API key and set this as the api_key value within lattice_config.ini
3. Create a virtual environment:
bash
python -m venv .venv
4. Activate and install dependencies:
bash
# Linux/macOS
source .venv/bin/activate
# Windows
.venv\Scripts\activate
pip install -r requirements.txt
## Usage
### Starting the Server in Binary Ninja
1. Open Binary Ninja and load a binary file
2. Go to Plugins > Start Lattice Protocol Server
3. The server will start and display the API key in the log console
4. Set the API key as the BNJLAT environment variable in your MCP configuration
Example MCP configuration (mcp.json):
json
"mcpServers": {
"binja-lattice-mcp": {
"command": "/path/to/BinjaLattice/.venv/bin/python",
"args": ["/path/to/BinjaLattice/mcp_server.py"],
"env": {
"BNJLAT": "your_api_key_here"
On Windows, use backslashes:
json
"mcpServers": {
"binja-lattice-mcp": {
"command": "C:\\path\\to\\BinjaLattice\\.venv\\Scripts\\python.exe",
"args": ["C:\\path\\to\\BinjaLattice\\mcp_server.py"],
"env": {
"BNJLAT": "your_api_key_here"
> Tip: The Windows installer outputs a ready-to-paste configuration with the correct paths.
### Available MCP Tools
The following tools are available through the MCP server:
#### Binary Information
get_binary_info: Get metadata about the binary (filename, architecture, entry point, segments, sections, function count)
get_all_function_names: List all function names in the binary
get_strings: Get strings with optional min_length and substring filter
get_imports: List imported functions with addresses and source libraries
get_exports: List exported functions with addresses
get_analysis_progress: Get Binary Ninja analysis status and progress percentage
#### Function Analysis
get_function_disassembly: Get assembly instructions for function by name
get_function_pseudocode: Get decompiled C-like pseudocode for function
get_function_variables: Get parameters, local variables, and global variables