Binary Reader MCP

by berlinbra
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports repository cloning and version control operations for installing and managing the MCP server.

  • Enables accessing the project repository and supports contribution workflows through pull requests.

  • Reads and analyzes Unreal Engine asset files (.uasset), extracting their metadata and structure to provide insights into binary file contents.

Binary Reader MCP

A Model Context Protocol server for reading and analyzing binary files. This server provides tools for reading and analyzing various binary file formats, with initial support for Unreal Engine asset files (.uasset).

Features

  • Read and analyze Unreal Engine .uasset files
  • Extract binary file metadata and structure
  • Auto-detect file formats
  • Extensible architecture for adding new binary format support

Installation

  1. Clone the repository:
git clone https://github.com/berlinbra/binary-reader-mcp.git cd binary-reader-mcp
  1. Create a virtual environment and activate it:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt

Usage

The server provides several tools through the Model Context Protocol:

1. Read Unreal Asset Files

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

2. Read Generic Binary Files

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

Development

Project Structure

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

Adding New Binary Format Support

To add support for a new binary format:

  1. Create a new reader class that inherits from BinaryReader
  2. Implement the required methods (read_header, read_metadata)
  3. Add the new format to the format auto-detection logic
  4. Update the tools list to include the new format

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

-
security - not tested
F
license - not found
-
quality - not tested

A Model Context Protocol server for reading and analyzing binary files, with initial support for Unreal Engine asset files (.uasset).

  1. Features
    1. Installation
      1. Usage
        1. 1. Read Unreal Asset Files
          1. 2. Read Generic Binary Files
          2. Development
            1. Project Structure
              1. Adding New Binary Format Support
              2. Contributing
                1. License