JinDaGe - binary_ninja_mcp MCP Details

article

README

🚀 Binary Ninja MCP

Binary Ninja MCP仓库包含一个Binary Ninja插件、MCP服务器和桥梁，可让Binary Ninja的功能与您喜爱的大语言模型（LLM）客户端实现无缝集成，极大提升二进制分析效率。

🚀 快速开始

安装

Binary Ninja插件

您可以通过Binary Ninja的插件管理器（Plugins > Manage Plugins）安装插件。插件管理器列表若要手动配置插件，可将此仓库复制到Binary Ninja插件文件夹中。

Claude Desktop Bridge（可选）

若您需要使用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

自动化设置Claude Desktop脚本

您可能需要运行以下命令来安装依赖项：

pip install pyinstaller requests

安装完成后

启动Claude Desktop。
在Binary Ninja中打开要分析的二进制文件。
在Claude Desktop中，导航到View > Extensions > Binary Ninja MCP Bridge。

✨ 主要特性

在线实时将Binary Ninja与MCP客户端集成，让您在分析过程中能及时借助外部智能。
增强的反编译工作流程，结合AI辅助功能，大大提高分析效率。
主要支持Claude Desktop作为MCP客户端，但可以扩展到其他集成，具有良好的扩展性。

💻 使用示例

基础用法

生成二进制分析报告

二进制分析报告生成

重命名函数

重命名函数演示

📚 详细文档

组件

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

一个Binary Ninja插件，提供MCP服务器，通过HTTP端点公开Binary Ninja的功能。这可以与任何实现MCP协议的客户端一起使用。
另一个单独的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 | 删除功能的评论。 | | get_assembly_function | 根据名称或地址获取功能的汇编表示。 |

开发

项目结构如下：

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

在代码中使用

要在代码中使用，请参考以下仓库：

binary-ninja-mcp

🔧 技术细节

先决条件

Binary Ninja
Python 3.12+
Claude Desktop（或其他您喜欢的集成）

📄 许可证

文档未提及许可证信息。

贡献

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

binary_ninja_mcp