Binary Ninja MCP <img src="images/binja.png" height="24" style="margin-left: 5px; vertical-align: middle;">

此仓库包含一个 Binary Ninja 插件、MCP 服务器和一个桥接器，可以实现 Binary Ninja 的功能与您最喜欢的 LLM 客户端的无缝集成。

功能

• Binary Ninja 和 MCP 客户端之间的无缝实时集成
• 通过 AI 辅助增强逆向工程工作流程
• 主要支持 Claude Desktop 作为 MCP 客户端，但可扩展以支持其他集成

示例

生成二进制分析报告

重命名函数

组件

此仓库包含两个独立的组件：

1. 一个 Binary Ninja 插件，提供一个 MCP 服务器，该服务器通过 HTTP 端点公开 Binary Ninja 的功能。这可以与任何实现 MCP 协议的客户端一起使用。
2. 一个独立的 MCP 桥接组件，将您最喜欢的 MCP 客户端连接到 Binary Ninja MCP 服务器。虽然 Claude Desktop 是主要的集成途径，但 MCP 服务器可以与其他客户端一起使用。

支持的集成

下表详细说明了当前支持与 Binary Ninja 的哪些集成。

功能	描述
get_binary_status	获取已加载二进制文件的当前状态。
list_classes	列出程序中的所有命名空间/类名。
list_data_items	列出定义的数据标签及其值。
list_exports	列出导出的函数/符号。
list_imports	列出程序中导入的符号。
list_methods	列出程序中的所有函数名。
list_namespaces	列出程序中所有非全局命名空间。
list_segments	列出程序中的所有内存段。
rename_data	重命名指定地址的数据标签。
rename_function	将函数按其当前名称重命名为新的用户定义名称。
search_functions_by_name	搜索名称包含给定子字符串的函数。
decompile_function	按名称反编译特定函数并返回反编译的 C 代码。
set_comment	在指定地址设置注释。
set_function_comment	为函数设置注释。
get_comment	获取指定地址的注释。
get_function_comment	获取函数的注释。
delete_comment	删除指定地址的注释。
delete_function_comment	删除函数的注释。

前提条件

• Binary Ninja
• Python 3.12+
• Claude Desktop（或您首选的集成）

安装

Binary Ninja 插件

您可以通过 Binary Ninja 的插件管理器安装插件 (Plugins > Manage Plugins)。

要手动配置插件，可以将此仓库复制到 Binary Ninja 插件文件夹中。

Claude Desktop 桥接器（可选）

只有当您想使用 Claude Desktop 作为您的 MCP 客户端时才需要此操作。 确保您已首先配置您的虚拟环境：

git clone git@github.com:fosdickio/binary_ninja_mcp.git
cd binary_ninja_mcp

python3 -m venv .venv
source .venv/bin/activate   # 在 macOS/Linux 上

pip install -r bridge/requirements.txt

自动配置 (Mac)

在 Mac 上，您可以通过运行以下命令来自动化设置：

./scripts/setup_claude_desktop.py

手动配置

在其他操作系统上或手动配置 Claude Desktop 集成：

1. 导航到 Settings > Developer > Edit Config
2. 添加以下配置：

{
  "mcpServers": {
    "binary_ninja_mcp": {
      "command": "/ABSOLUTE/PATH/TO/binary_ninja_mcp/.venv/bin/python",
      "args": [
        "/ABSOLUTE/PATH/TO/binary_ninja_mcp/bridge/binja_mcp_bridge.py"
      ]
    }
  }
}

注意：将 /ABSOLUTE/PATH/TO 替换为您的项目目录的实际绝对路径。 必须使用虚拟环境的 Python 解释器才能访问已安装的依赖项。

用法

Claude Desktop

1. 打开 Binary Ninja 并安装 Binary Ninja MCP 插件
2. 重启 Binary Ninja，然后打开一个二进制文件
3. 启动 MCP 服务器 (Plugins > MCP Server > Start MCP Server)
4. 启动 Claude Desktop

打开 Claude Desktop 后，集成将自动可用。

您现在可以开始提示 Claude 关于当前打开的二进制文件。 示例提示：

• "为当前二进制文件生成二进制分析报告。"
• "在当前二进制文件中将函数 X 重命名为 Y。"
• "列出当前二进制文件中的所有函数。"
• "已加载二进制文件的状态是什么？"

其他 MCP 客户端集成

通过实现适当的集成层，该桥接器可以与其他 MCP 客户端一起使用。

开发

项目结构组织如下：

binary_ninja_mcp/
├── bridge/                      # MCP 客户端集成
├── plugin/                      # Binary Ninja 插件
├── scripts/
│   └── setup_claude_desktop.py  # Claude Desktop 的设置脚本

贡献

欢迎贡献。 请随时提交拉取请求。