Another™ Binary Ninja 的 MCP 服务器

<div align="center">

Binary Ninja 的 MCP (模型上下文协议) 服务器

</div>

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  # 只运行一次
   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
# 安装 binaryninja API
binaryninja-mcp install-api
# 检查 API 是否正确安装
uv run python -c 'import binaryninja as bn; print(f"ui_enabled={bn.core_ui_enabled()}")'

设置用于开发的 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
# 要更新测试快照：
pytest --snapshot-update

版本 Bump

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

请参阅：Versioning - Hatch

发布

uv publish

许可证

Apache 2.0