arga_enfusion_mcp

An MCP server that lets an AI agent read Arma Reforger .pak archives and resolve GUIDs from resourceDatabase.rdb, instead of answering from memory.

It wraps the open-source enfusion_tools CLI (MIT, by landaire) for the .pak formats, and parses the .rdb in pure Python.

This project uses landaire/enfusion_tools. It does not reimplement the .pak format: every pak_* tool runs the enfusion binary built from that repository, so you need it installed (see Requirements).

resourceDatabase.rdb is not compressed: it is a flat index of resource paths and GUIDs. .pak files are read by index, without unpacking them first.

Requirements

• Python 3.12+ and uv

• The enfusion CLI binary from enfusion_tools (prebuilt in its Releases, or cargo build --release)

• Arma Reforger installed

Related MCP server: enfusion-mcp

Setup

uv sync

Configuration is read from environment variables:

Register with an MCP client

Claude Code:

claude mcp add arga-enfusion \
  --env ENFUSION_CLI="C:\path\to\enfusion.exe" \
  --env REFORGER_DATA_DIR="C:\path\to\Arma Reforger\addons\data" \
  --env REFORGER_MODS_DIR="C:\path\to\My Games\ArmaReforger\addons" \
  -- uv --directory "C:\path\to\arga_enfusion_mcp" run arga-enfusion-mcp

Any client that takes a JSON server definition:

{
  "mcpServers": {
    "arga-enfusion": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\arga_enfusion_mcp", "run", "arga-enfusion-mcp"],
      "env": {
        "ENFUSION_CLI": "C:\\path\\to\\enfusion.exe",
        "REFORGER_DATA_DIR": "C:\\path\\to\\Arma Reforger\\addons\\data",
        "REFORGER_MODS_DIR": "C:\\path\\to\\My Games\\ArmaReforger\\addons"
      }
    }
  }
}

Tools

Every tool takes a source: a short name, never a filesystem path.

For rdb_*, source is the resource database: data (default), core, or a mod folder name.

Notes

• Where things live (vanilla): data007 holds the scripts (.c), Prefabs, Configs, Particles, Missions and Language. data008/data009 hold Sounds, data010 Terrains and UI. A mod has a single data.pak.

• Empty is not absent. An empty result only covers the source you searched.

• Configs inherit through parent. Finding the file is not finding the value: a field can be defined two levels up.

• Paths: pak_glob returns paths with a leading /. The .rdb stores them without one; rdb_guid_of accepts both.

• GUIDs: the brace form in .et/.conf/.ptc files is the 8 stored bytes reversed, as uppercase hex.

• Output is bounded and the CLI has a timeout. Truncated output says so.

Safety model

• Clients never send paths. A source name is validated (no separators, no ..) and looked up under the configured directories only.

• The CLI runs without a shell, and positional arguments go after --.

• pak_extract writes only under REFORGER_EXTRACT_DIR, in a subfolder named after the source.

• Anticipated failures (unknown source, missing config, CLI error) are returned to the model as tool errors with a readable message.

Development

uv run pytest
uv run ruff check .
uv run ruff format .

A test that reads the real resourceDatabase.rdb runs only when REFORGER_DATA_DIR is set.

Credits

Pak reading is done by enfusion_tools by landaire.

Español

Servidor MCP que permite a un agente de IA leer archivos .pak de Arma Reforger y resolver GUIDs desde resourceDatabase.rdb, en lugar de responder de memoria.

Envuelve la CLI open source enfusion_tools (MIT, de landaire) para los formatos .pak, y analiza el .rdb en Python puro.

Este proyecto usa landaire/enfusion_tools. No reimplementa el formato .pak: cada herramienta pak_* ejecuta el binario enfusion compilado desde ese repositorio, por lo que es necesario tenerlo instalado (ver Requisitos).

resourceDatabase.rdb no está comprimido: es un índice plano de rutas de recursos y GUIDs. Los .pak se leen por índice, sin desempaquetarlos primero.

Requisitos

• Python 3.12+ y uv

• El binario de la CLI enfusion de enfusion_tools (precompilado en sus Releases, o con cargo build --release)

• Arma Reforger instalado

Instalación

uv sync

La configuración se lee de variables de entorno:

Registro en un cliente MCP

Claude Code:

claude mcp add arga-enfusion \
  --env ENFUSION_CLI="C:\ruta\a\enfusion.exe" \
  --env REFORGER_DATA_DIR="C:\ruta\a\Arma Reforger\addons\data" \
  --env REFORGER_MODS_DIR="C:\ruta\a\My Games\ArmaReforger\addons" \
  -- uv --directory "C:\ruta\a\arga_enfusion_mcp" run arga-enfusion-mcp

Cualquier cliente que acepte una definición de servidor en JSON:

{
  "mcpServers": {
    "arga-enfusion": {
      "command": "uv",
      "args": ["--directory", "C:\ruta\a\arga_enfusion_mcp", "run", "arga-enfusion-mcp"],
      "env": {
        "ENFUSION_CLI": "C:\ruta\a\enfusion.exe",
        "REFORGER_DATA_DIR": "C:\ruta\a\Arma Reforger\addons\data",
        "REFORGER_MODS_DIR": "C:\ruta\a\My Games\ArmaReforger\addons"
      }
    }
  }
}

Herramientas

Todas las herramientas reciben un source: un nombre corto, nunca una ruta del sistema de archivos.

Para rdb_*, source es la base de recursos: data (por defecto), core, o el nombre de la carpeta de un mod.

Notas

• Dónde está cada cosa (vanilla): data007 contiene los scripts (.c), Prefabs, Configs, Particles, Missions y Language. data008/data009 contienen Sounds, data010 Terrains y UI. Un mod tiene un único data.pak.

• Vacío no es ausente. Un resultado vacío solo cubre la fuente que se buscó.

• Los configs heredan por parent. Encontrar el archivo no es encontrar el valor: un campo puede estar definido dos niveles más arriba.

• Rutas: pak_glob devuelve rutas con / inicial. El .rdb las guarda sin él; rdb_guid_of acepta ambas.

• GUIDs: la forma entre llaves en los .et/.conf/.ptc son los 8 bytes almacenados invertidos, en hexadecimal mayúscula.

• La salida está acotada y la CLI tiene un timeout. Si la salida se trunca, se indica.

Modelo de seguridad

• Los clientes nunca envían rutas. El nombre de la fuente se valida (sin separadores ni ..) y se busca únicamente bajo los directorios configurados.

• La CLI se ejecuta sin shell, y los argumentos posicionales van después de --.

• pak_extract escribe solo bajo REFORGER_EXTRACT_DIR, en una subcarpeta con el nombre de la fuente.

• Los fallos previstos (fuente desconocida, configuración faltante, error de la CLI) se devuelven al modelo como errores de herramienta con un mensaje legible.

Desarrollo

uv run pytest
uv run ruff check .
uv run ruff format .

Un test que lee el resourceDatabase.rdb real se ejecuta solo cuando REFORGER_DATA_DIR está definida.

Créditos

La lectura de .pak la hace enfusion_tools, de landaire.