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

Clone the repository:

git clone https://github.com/berlinbra/binary-reader-mcp.git
cd binary-reader-mcp

Create a virtual environment and activate it:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

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:

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

Contributing

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

License

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

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

local-only server

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

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

Filesystem MCP Server
bsmi021
-
security
A
license
-
quality
A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
Last updated -
4
TypeScript
MIT License
File Operations MCP Server
bsmi021
A
security
A
license
A
quality
A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
Last updated -
12
15
TypeScript
MIT License
Unstructured Document Processor MCP
MKhalusova
-
security
F
license
-
quality
A Model Context Protocol server that enables LLMs to extract and use content from unstructured documents across a wide variety of file formats.
Last updated -
6
Python
MCP Filesystem Server
safurrier
A
security
A
license
A
quality
A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
Last updated -
21
42
Python
MIT License

View all related MCP servers

Appeared in Searches

Information on Unreal Engine

Binary Reader MCP