Lector binario MCP

Un servidor de Protocolo de Contexto de Modelo para leer y analizar archivos binarios. Este servidor proporciona herramientas para leer y analizar diversos formatos de archivos binarios, con compatibilidad inicial con archivos de recursos de Unreal Engine (.uasset).

Características

• Leer y analizar archivos .uasset de Unreal Engine

• Extraer metadatos y estructura de archivos binarios

• Detección automática de formatos de archivo

• Arquitectura extensible para agregar compatibilidad con nuevos formatos binarios

Related MCP server: File Operations MCP Server

Instalación

1. Clonar el repositorio:

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

2. Crea un entorno virtual y actívalo:

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

3. Instalar dependencias:

pip install -r requirements.txt

Uso

El servidor proporciona varias herramientas a través del Protocolo de Contexto de Modelo:

1. Leer archivos de activos de Unreal

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

2. Leer archivos binarios genéricos

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

Desarrollo

Estructura del proyecto

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

Añadiendo compatibilidad con nuevos formatos binarios

Para agregar soporte para un nuevo formato binario:

1. Cree una nueva clase de lector que herede de BinaryReader

2. Implementar los métodos requeridos ( read_header , read_metadata )

3. Añade el nuevo formato a la lógica de detección automática de formato

4. Actualice la lista de herramientas para incluir el nuevo formato

Contribuyendo

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.