binary-reader-mcp
3.1
If you are the rightful owner of binary-reader-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Binary Reader MCP is a Model Context Protocol server designed for reading and analyzing binary files, with a focus on Unreal Engine asset files.
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.
