Umodel-MCP

English | 简体中文

An MCP server for umodel that lets any MCP client list, extract, and export Unreal Engine game assets through natural language.

Features

• Zero-dependency extraction: pak_list / pak_extract are pure TypeScript implementations that parse the .pak index directly and extract raw .uasset/.uexp files — no umodel download required

• Encrypted pak support: AES-256 index/entry encryption, including the standard mode and the bitflip variant; keys are held in session memory only

• Full export pipeline: meshes, textures, animations, and sounds are exported to gltf, psk, png, dds, and other formats (requires the umodel executable)

Related MCP server: L2 Modding MCP

Requirements

• Node.js 18 or later

• Any MCP-capable client (Hermes, Claude Code, Cursor, PI, Codex, etc.)

• Only needed for export/conversion: umodel

Installation

Standard config

{
  "mcpServers": {
    "umodel": {
      "command": "npx",
      "args": ["-y", "umodel-mcp"]
    }
  }
}

You can also just tell your agent: "Install and register umodel-mcp, reload the MCP connection, and verify it works."

claude mcp add umodel npx -- -y umodel-mcp

codex mcp add umodel npx "-y" "umodel-mcp"

git clone git@github.com:CHA1007/Umodel-MCP.git
cd Umodel-MCP
npm install
npm run build

Then register it in your MCP client config:

{
  "mcpServers": {
    "umodel": {
      "command": "node",
      "args": ["<absolute path to this repo>/dist/index.js"]
    }
  }
}

Tools

Command-line arguments follow the official UEViewer source (UmodelTool/Main.cpp); each tool's parameters can be inspected via its schema in your MCP client.

Disclaimer

• This project is intended only for unpacking, viewing, and exporting game assets that the user legally owns, for learning, research, backup, and other lawful purposes

• Please comply with the user agreement of the game in question and the laws and regulations of your jurisdiction; the author assumes no responsibility for any copyright or agreement disputes or damages arising from the use of this project

License

MIT © CHA1007