Binary Ninja 接入 MCP 工具完整教程：让 AI 驱动二进制逆向分析#

1.1 版本要求#

Binary Ninja Free 版本不支持的场景，可改用 GhidraMCP 替代。Python 版本需 ≥ 3.12。

1.2 环境预检查#

1
python --version    # 需 ≥ 3.12
2
git --version       # 手动安装时需要

MCP 客户端需在安装插件之前先安装好，插件安装过程会自动检测并配置已安装的客户端。

2.1 方式一：通过 Binary Ninja 插件管理器安装（推荐）#

1. 打开 Binary Ninja
2. 导航到 Plugins > Manage Plugins
3. 搜索 “Binary Ninja MCP”
4. 点击 Install
5. 重启 Binary Ninja

插件管理器会自动完成以下操作：

• 下载插件到 Binary Ninja 插件目录
• 创建 Python 虚拟环境（.venv）
• 安装 Python 依赖（bridge/requirements.txt）
• 检测并自动配置已安装的 MCP 客户端
• 创建 .mcp_auto_setup_done 标记文件，避免重复配置

2.2 方式二：手动安装#

如需手动安装，将仓库克隆到 Binary Ninja 插件目录：

1
# macOS
2
cd ~/Library/Application\ Support/Binary\ Ninja/plugins/
3
git clone https://github.com/fosdickio/binary_ninja_mcp
4

5
# Linux
6
cd ~/.binaryninja/plugins/
7
git clone https://github.com/fosdickio/binary_ninja_mcp
8

9
# Windows
10
cd %APPDATA%\Binary Ninja\plugins\
11
git clone https://github.com/fosdickio/binary_ninja_mcp

手动安装后重启 Binary Ninja，插件会在首次加载时自动执行配置流程。

2.3 自动客户端配置#

插件支持自动检测和配置以下 MCP 客户端：

3.1 使用 npm 包配置（推荐）#

Binary Ninja MCP 提供了 npm 包，配置最为简洁。在 MCP 客户端配置文件中添加：

1
{
2
  "mcpServers": {
3
    "binary-ninja-mcp": {
4
      "command": "npx",
5
      "args": ["-y", "binary-ninja-mcp", "--host", "localhost", "--port", "9009"]
6
    }
7
  }
8
}

3.2 使用 Python 桥接配置（手动模式）#

Claude Desktop 用户可通过配置文件路径进行手动配置：

macOS 配置文件位置：

1
~/Library/Application Support/Claude/claude_desktop_config.json

Windows 配置文件位置：

1
%APPDATA%\Claude\claude_desktop_config.json

添加以下内容（注意替换绝对路径）：

1
{
2
  "mcpServers": {
3
    "binary_ninja_mcp": {
4
      "command": "/绝对路径/到/binary_ninja_mcp/.venv/bin/python",
5
      "args": [
6
        "/绝对路径/到/binary_ninja_mcp/bridge/binja_mcp_bridge.py"
7
      ]
8
    }
9
  }
10
}

注意：必须使用虚拟环境中的 Python 解释器，确保依赖项可用。

3.3 命令行工具管理#

插件提供了命令行管理工具用于手动控制客户端配置：

1
# 自动配置所有已安装的 MCP 客户端
2
python scripts/mcp_client_installer.py --install
3

4
# 移除所有 MCP 客户端配置
5
python scripts/mcp_client_installer.py --uninstall
6

7
# 输出通用 JSON 配置片段
8
python scripts/mcp_client_installer.py --config

4.1 启动 MCP 服务器#

1. 打开 Binary Ninja，加载目标二进制文件
2. 启动 MCP 服务器：Plugins > MCP Server > Start MCP Server
3. 状态栏左下角会显示服务器运行状态

4.2 连接 AI 客户端#

以 Claude Desktop 为例：

1. 确保 Binary Ninja 中 MCP 服务器已启动
2. 启动 Claude Desktop
3. 集成自动生效，在对话中直接询问当前二进制文件的相关问题

4.3 多文件支持#

Binary Ninja MCP 支持同时打开多个二进制文件。当切换活动标签页时，AI 客户端的分析上下文会自动跟随当前活跃的目标。

5.1 元信息与导航#

5.2 反编译与分析#

5.3 重命名#

5.4 注释管理#

5.5 类型编辑#

6.1 生成二进制分析报告#

提示词：

1
为当前二进制文件生成一份完整的分析报告，包括文件基本信息、段布局、
2
导入/导出符号概览、关键函数识别和潜在的安全关注点。

AI 将依次调用 get_binary_status、list_segments、list_exports、list_imports 等工具，聚合信息生成结构化报告。

6.2 批量函数重命名#

提示词：

1
分析当前二进制文件的导入表，将每个导入函数被调用的所有包装函数
2
（如 sub_xxxxxx 形式的函数）重命名为有意义的名字，格式为 wrapper_<导入函数名>。
3
只处理直接包装函数（函数体小于 10 行汇编）。

AI 会先调用 list_imports 获取导入符号，然后对每个符号使用 code_references 查找调用者，调用 get_assembly_function 判断函数大小，最后通过 rename_function 批量重命名。

6.3 数据结构逆向#

提示词：

1
搜索当前二进制文件中所有引用 malloc 且分配大小 ≤ 0x100 的位置。
2
对每个分配点，推断被分配的结构体类型，使用 define_types 定义对应结构体，
3
然后用 retype_variable 为变量设置类型。

AI 会追踪 malloc 调用的交叉引用，分析分配后的字段访问模式来推断结构体布局，再定义类型并应用。

6.4 CTF 解题辅助#

提示词：

1
目标：找出用于验证输入的密钥或密码逻辑。
2
步骤：
3
1. 搜索 "Correct"、"Wrong"、"Success"、"Fail" 等字符串
4
2. 追踪这些字符串的交叉引用，找到判断逻辑所在的函数
5
3. 反编译这些函数，分析密码验证算法
6
4. 如果需要逆向算法，推导出正确输入

6.5 漏洞搜索#

提示词：

1
在当前二进制文件中搜索潜在的内存安全漏洞：
2
1. 找到所有调用 strcpy、sprintf、gets 的函数
3
2. 分析每次调用，判断目标缓冲区大小是否足以容纳源数据
4
3. 对于缓冲区可能不足的情况，标注为目标漏洞点
5
4. 对每个潜在漏洞点，检查是否有栈保护（canary）、ASLR 等缓解措施

Q1：插件安装后 MCP 客户端没有自动配置？#

A：检查 MCP 客户端是否先于插件安装。如果安装顺序反了，可以重新安装插件触发自动检测，或使用命令行工具手动配置：

1
python scripts/mcp_client_installer.py --install

Q2：npm 模式下连接失败？#

A：确认 Binary Ninja 中 MCP 服务器已启动（Plugins > MCP Server > Start MCP Server）。默认端口为 9009，可在启动时确认日志输出。

Q3：Claude Desktop 报 “Could not find module”？#

A：手动安装模式下需确保虚拟环境中已安装依赖：

1
cd /path/to/binary_ninja_mcp
2
python3 -m venv .venv
3
source .venv/bin/activate       # macOS/Linux
4
.venv\Scripts\activate          # Windows
5
pip install -r bridge/requirements.txt

Q4：能否在无图形界面的服务器上使用？#

A：当前版本依赖 Binary Ninja GUI 启动 MCP 服务器。无头（headless）模式暂不支持，可关注项目后续更新。