Another™ MCP Server for Binary Ninja

Another™ MCP Server for Binary Ninja

English | 中文

演示

tests/binary/beleaf.elf 取自 CSAW'19：Beleaf - Nightmare。 你也可以通过上面的链接查看完整的分析文章！

……但为什么是 Another？

请参阅： 与现有插件的主要区别

安装

服务端设置

有两种方式可以运行 MCP 服务：

1. Binary Ninja UI 插件：

   • 通过 Binary Ninja 的插件管理器安装插件
   • 首次加载文件时，MCP 服务会自动启动。
     • 可通过 Settings - MCP Server - Auto Start 配置自动启动
     • 可通过 Settings - MCP Server - Server port number 配置监听端口
   • 所有已打开的文件都会作为独立资源公开，详见下方的 可用资源部分

2. Binary Ninja 无头模式：

   uvx binaryninja-mcp install-api  # only run once
   uvx binaryninja-mcp server <filename> [filename]...
   

   • filename 可以是任意二进制文件或 BNDB；与 UI 模式类似，所有已打开的 文件都可供 MCP 客户端使用。
   • 服务默认运行在端口 7000
   • 使用 --port 标志指定其他端口

MCP 客户端设置

1. Claude Desktop（stdio 中继客户端）：配置客户端，通过内置中继使用 stdio 传输进行连接。

   {
     "mcpServers": {
       "binaryninja": {
         "command": "uvx",
         "args": ["binaryninja-mcp", "client"]
       }
     }
   }
   

2. Cherry Studio：

   • SSE 端点（推荐）：URL：http://localhost:7000/sse
   • stdio 客户端：
     • 命令：uvx
     • 参数：

       binaryninja-mcp
       client
       

如果希望 MCP 服务使用非默认端口，请在服务端和客户端的命令行中都添加 --port 12345。

MCP 客户端可用工具

MCP 服务提供以下工具：

• rename_symbol：重命名函数或数据变量
• pseudo_c：获取指定函数的伪 C 代码
• pseudo_rust：获取指定函数的伪 Rust 代码
• high_level_il：获取指定函数的高级 IL
• medium_level_il：获取指定函数的中级 IL
• disassembly：获取函数或指定范围的反汇编
• update_analysis_and_wait：更新二进制文件的分析并等待完成
• get_triage_summary：获取 BinaryNinja Triage 视图的基本信息
• get_imports：获取导入符号的字典
• get_exports：获取导出符号的字典
• get_segments：获取内存段列表
• get_sections：获取二进制文件的节列表
• get_strings：获取二进制文件中的字符串列表
• get_functions：获取函数列表
• get_data_variables：获取数据变量列表

MCP 客户端可用资源

MCP 资源可通过以下格式的 URI 访问： binaryninja://{filename}/{resource_type}

对于每个二进制文件，服务会提供以下资源类型：

• triage_summary：BinaryNinja Triage 视图中的基本信息
• imports：导入符号/函数的字典
• exports：导出符号/函数的字典
• segments：内存段列表
• sections：二进制文件节列表
• strings：在二进制文件中找到的字符串列表
• functions：函数列表
• data_variables：数据变量列表

开发

uv 是此项目推荐的包管理工具。

将目录克隆到 Binary Ninja 插件目录

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

设置 Python 环境

必须手动将 Binary Ninja API 安装到 virtualenv 中。

uv venv
uv sync --dev
# install binaryninja API
binaryninja-mcp install-api
# check API is correctly installed
uv run python -c 'import binaryninja as bn; assert bn._init_plugins() is None; assert bn.core_ui_enabled() is not None; print("BN API check PASSED!!")'

为开发设置 MCP 客户端

对于使用 stdio 传输的 MCP 客户端（如 Claude Desktop），请将工作目录切换到开发文件夹。

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

启用了 SSE 的 MCP 客户端可以通过以下地址连接：http://localhost:7000/sse

构建

uv build

测试

pytest
# To update test snapshots:
pytest --snapshot-update

版本更新

PyPI 包版本会根据 Binary Ninja 的 plugin.json（采用 package.json 格式）自动派生，以保持 BN 插件和 PyPI 包的版本一致。

# bump alpha version
uvx hatch version a

# bump release version
uvx hatch version minor,rc
uvx hatch version release

参见：版本管理 - Hatch

发布

uv publish

许可证

Apache 2.0