Skip to main content
Glama

Umodel-MCP

License: MIT GitHub

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

Tool

umodel command

Description

umodel_session_get

—

Show the current in-memory session settings

umodel_session_set

—

Remember session settings (in memory only, nothing written to disk)

umodel_find_exe

—

Auto-search for the umodel executable (fallback only, when the user does not know the path)

umodel_version

-version

Verify the executable (pass exe to test and remember a new path)

umodel_game_list

-gamelist / -taglist

List supported games and their -game= tags

umodel_list_packages

—

Recursively scan a directory for .pak/.upk/.uasset/.ut2 package files

umodel_list_objects

-list

List objects in a package (filtering and pagination supported)

umodel_package_info

-pkginfo

Show package info (name/export tables)

umodel_export

-export

Export meshes/textures/animations/sounds (psk, gltf, png, dds…)

umodel_save

-save

Copy raw package files out as-is (.upk + .uexp/.ubulk)

umodel_list_output

—

Show the exported directory tree (with file sizes)

pak_list

—

Parse the .pak index directly (no umodel), AES-encrypted indexes supported, search asset paths

pak_extract

—

Extract raw .uasset/.uexp files from a .pak (encrypted paks supported)

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

Available Tools

13 tools
pak_extractExtract files from UE .pak archivesA

Extract raw .uasset/.uexp files from UE .pak archives by parsing the index directly (AES-encrypted indexes supported, including custom bit-flipped AES). Works without umodel. The extracted loose files can then be converted with umodel_export (point it at the output directory). Output defaults to /pak under the Downloads folder.

Inputs: filters (required), out, json, aesKey, +4 more.

pak_listList files inside UE .pak archivesA

Parse UE .pak index files (AES-encrypted indexes supported, including games using custom bit-flipped AES) and list asset paths matching the filters. Works without umodel. Use this before pak_extract to locate assets (meshes/textures/animations). The pak directory should come from the user — ask which game directory to unpack first.

Inputs: filters (required), json, limit, aesKey, +3 more.

umodel_exportExport assets from a packageA

Run 'umodel -export' to convert assets (meshes, textures, animations, sounds...) to standard formats (psk/gltf/tga/png/...). Without object filters the whole package is exported. Output defaults to the Downloads folder. IMPORTANT: cooked UE4/5 games need a gameTag, otherwise umodel pops a blocking engine-version GUI dialog. ALWAYS call umodel_game_list { tags: true } FIRST and use the official tag if the game is listed (e.g. roco); the server blocks the call and reminds you if gameTag is missing.

Inputs: package (required), out, json, lods, +15 more.

umodel_find_exeAuto-locate umodel executableA

Search common locations (Downloads/Desktop/Documents/Program Files/PATH...) for umodel executables (umodel.exe, umodel_64.exe, or custom builds like umodel_acl_*.exe). ONLY use this as a fallback when the user does not know the umodel path or provided an invalid one — always ask the user for the path first. With verify=true the newest candidate is tested via -version and remembered. IMPORTANT: different umodel builds/versions support different games (e.g. umodel_acl variants). If more than one candidate is found the remembered exe stays UNCONFIRMED and per-game tools refuse to run until you show the candidate list to the user, ask which version to use for the target game, and confirm it via umodel_session_set { umodelExe }. Never pick a version yourself.

Inputs: dirs, json, verify.

umodel_game_listList supported gamesA

List games supported by umodel. With tags=true shows the short tags usable with -game=/gameTag. Check this BEFORE any list/export/save call: if the user's game appears (e.g. Roco Kingdom: World -> roco), remember it via umodel_session_set { gameTag } so later calls don't pop the blocking engine-version GUI dialog.

Inputs: tags.

umodel_list_objectsList contents of a packageC

Run 'umodel -list ' to list objects contained in a package.

Inputs: package (required), json, skip, limit, +4 more.

umodel_list_outputShow exported files directory treeA

List the folder structure and files produced by umodel_export/umodel_save, with sizes. Use this after an export to see what was unpacked.

Inputs: maxDepth, directory, maxEntries.

umodel_list_packagesFind package files in a game directoryA

Recursively scan a directory for Unreal package files (.pak/.upk/.uasset/.ut2/...) so you know what to pass to other tools. The directory should come from the user — ask which game directory to unpack before scanning.

Inputs: json, limit, directory, extensions.

umodel_package_infoShow package infoB

Run 'umodel -pkginfo ' to display package summary (name table, export table).

Inputs: package (required), json, aesKeys, gameTag, +1 more.

umodel_saveSave raw packagesA

Run 'umodel -save' to copy raw package files (.upk/.uasset + .uexp/.ubulk) out of a game directory, e.g. to unpack a cooked game without converting. Output defaults to the Downloads folder.

Inputs: package (required), out, json, aesKeys, +3 more.

umodel_session_getShow current session settingsA

Show the in-memory session settings (umodel exe, game directory, output directory, AES keys). No config file is used; settings live only for this server session.

Inputs: no named parameters.

umodel_session_setRemember session settingsA

Store settings in the in-memory session (nothing is written to disk). NOTE: most values (gamePath/gameTag/aesKeys/pakAesKey/pakAesMode) are auto-remembered whenever you pass them to any tool, so you rarely need this tool — use it only to set values ahead of time, clear them (empty string), or configure pure settings: umodelExe (user-confirmed), outputDir, pakAesMode. IMPORTANT: umodelExe and gamePath must come from the user — ask the user for the umodel executable path and the game/pak directory before setting them; never guess. Only fall back to umodel_find_exe when the user does not know the path or the given path is wrong. Pass an empty string to clear a field. outputDir defaults to the Downloads folder when unset.

Inputs: aesKeys, gameTag, gamePath, outputDir, +3 more.

umodel_versionVerify umodel executableA

Run 'umodel -version' to verify the executable works. Pass exe to test a new path; if it works it is remembered in the session.

Inputs: exe.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct action: session management, exe discovery, directory scanning, pak parsing, export/save, and listing outputs/objects. Even similar list tools are differentiated by input type (directory, pak index, package, output folder). Descriptions clearly specify each tool's unique role.

    Naming Consistency3/5

    All tools share a umodel_ or pak_ prefix, providing a clear family relationship, but the verb-noun structure is inconsistent: some are verb-first (umodel_list_objects, umodel_export), some noun-first (umodel_game_list, umodel_package_info), and some use noun-verb pairs (umodel_session_get/set). While readable, there is no uniform naming pattern.

    Tool Count5/5

    13 tools is well-scoped for an asset extraction workflow. Each tool earns its place, covering exe management, session settings, scanning, listing, exporting, saving, and pak operations without redundancy.

    Completeness5/5

    The tool set covers the full pipeline from finding the umodel executable and setting session config to scanning directories, listing packages/paks, exporting/saving assets, and verifying output. Necessary helpers like game tag lookup and version checking are included, leaving no significant gaps for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches