AI导哈

二进制文件分析工具

一个用于读取和分析二进制文件的模型上下文协议服务器，支持Unreal Engine资产文件（.uasset）等多种二进制文件格式。

  • by berlinbra
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 berlinbra/binary-reader-mcp

使用说明

二进制读取器MCP

用于读取和分析二进制文件的模型上下文协议服务器。此服务器提供用于读取和分析各种二进制文件格式的工具，最初支持虚幻引擎资源文件（.uasset）。

特性

  • 读取并分析虚幻引擎.uasset文件
  • 提取二进制文件元数据和结构
  • 自动检测文件格式
  • 用于添加新二进制格式支持的可扩展架构

安装

  1. 克隆存储库：
git clone https://github.com/berlinbra/binary-reader-mcp.git
cd binary-reader-mcp
  1. 创建虚拟环境并激活它：
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装依赖项：
pip install -r requirements.txt

用法

服务器通过模型上下文协议提供了几个工具：

1.读取虚幻资源文件

# Example usage through MCP
tool: read-unreal-asset
arguments:
    file_path: "path/to/your/asset.uasset"

2.读取通用二进制文件

# Example usage through MCP
tool: read-binary-metadata
arguments:
    file_path: "path/to/your/file.bin"
    format: "auto"  # or "unreal", "custom"

发展

项目结构

binary-reader-mcp/
├── README.md
├── requirements.txt
├── main.py
├── src/
│   ├── __init__.py
│   ├── binary_reader/
│   │   ├── __init__.py
│   │   ├── base_reader.py
│   │   ├── unreal_reader.py
│   │   └── utils.py
│   ├── api/
│   │   ├── __init__.py
│   │   ├── routes.py
│   │   └── schemas.py
│   └── config.py
└── tests/
    ├── __init__.py
    ├── test_binary_reader.py
    └── test_api.py

添加新的二进制格式支持

要添加对新二进制格式的支持，请执行以下操作：

  1. 创建一个新的读取器类，该类继承自 BinaryReader
  2. 实施所需的方法(read_header, read_metadata)
  3. 将新格式添加到格式自动检测逻辑中
  4. 更新工具列表以包含新格式

贡献

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/amazing-feature)
  3. 提交您的更改(git commit -m 'Add some amazing feature')
  4. 推到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP