Binaryninja MCP

🚀 Another™ MCP 服務器用於 Binary Ninja

Another™ MCP 服務器是一款為 Binary Ninja 打造的插件，它為每個分析的二進制文件配備了強大的 Web 服務器，支持重命名符號、生成偽代碼和中間表示等多種功能。

🚀 快速開始

Another™ MCP Server 是一個用於 Binary Ninja 的插件，為每個分析的二進制文件提供了一個強大的 Web 服務器。該服務器支持多種功能，包括重命名符號、生成偽代碼和中間表示（IR）、提取字符串、查找段和節等。

✨ 主要特性

• 功能豐富：支持重命名符號、生成偽代碼和中間表示（IR）、提取字符串、查找段和節等多種功能。
• 資源多樣：為每個二進制文件提供 triage_summary、imports、exports 等多種資源類型。

📦 安裝指南

服務器設置

1. 克隆倉庫到 Binary Ninja 插件目錄：

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

2. 安裝 Python 環境： 使用 uv 工具管理 Python 環境：

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

3. 運行服務器： 在插件目錄中，使用以下命令啟動服務器：

   uv run python -m binaryninja_mcp.server
   

客戶端設置

1. 配置 MCP 客戶端（例如 Claude Desktop）的 config.json 文件：

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

2. SSE 客戶端連接： 使用以下 URL 連接到 SSE（服務器發送事件）服務：

   http://localhost:7000/sse
   

💻 使用示例

基礎用法

重命名符號

import binaryninja as bn

# 示例：將函數重命名為 "main"
func = bn.current_function()
func.name = "main"

生成偽代碼和 IR

# 獲取當前函數的偽代碼
pseudo_code = bn.current_function().get_pseudo_code()

# 獲取中間表示（LLVM IR）
ir = bn.current_function().get_llil()

🔧 技術細節

資源

MCP 服務器為每個二進制文件提供以下資源類型：

開發

環境搭建

1. 克隆倉庫並安裝依賴：

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

2. 運行開發服務器：

   uv run python -m binaryninja_mcp.server --dev
   

3. 測試：

   pytest
   pytest --snapshot-update  # 更新測試快照
   

版本控制

使用 uvx 和 hatch 進行版本管理：

uvx hatch version a       # 增加測試版
uvx hatch version minor,rc  # 發佈候選版本
uvx hatch version release   # 發佈正式版本

發佈

uv publish

📄 許可證

Apache 2.0

演示

項目地址： https://github.com/MCPPhalanx/binaryninja-mcp