MCP UAsset Toolkit

Give AI assistants tools to inspect, edit, and package Unreal Engine assets through MCP. Built on .NET 10, UAssetAPI, and CUE4Parse, with optional retoc integration for IoStore.

What it does

• Inspect assets: headers, names, imports, exports, properties, mappings, and searchable metadata.
• Edit in memory: primitive properties, nested structs/arrays/maps, DataTables, export data, and raw or script bytes.
• Validate and save: JSON import/export, serialization checks, binary comparison, save-as, and protected reload/discard.
• Work with archives: browse CUE4Parse packages, supply AES keys, extract companion files, and create .pak archives.
• Use IoStore: inspect, verify, and convert containers through an installed retoc executable.

See the capability guide for tool names, examples, and compatibility limits. It maps practical UAssetGUI workflows to MCP tools; game support depends on the underlying libraries, engine version, and mappings. Visual media previews and media conversion are not included.

Quick start

Requires Windows x64 and the .NET 10 SDK to build from source.

git clone --recurse-submodules https://github.com/hedgehogform/MCP-UAsset-Toolkit.git
cd MCP-UAsset-Toolkit
dotnet run --project "MCP UAsset Toolkit.csproj"

For an existing checkout, initialize its pinned dependency with git submodule update --init --recursive.

Connect your MCP client to http://127.0.0.1:13338/sse using its HTTP server configuration. The server binds to loopback by default; change the endpoint in appsettings.json if needed.

A typical asset workflow is open_asset → inspect/search → edit → validate_asset → save_asset. Edits stay in the session until saved. Dirty sessions require an explicit discard before closing or reloading.

Optional retoc

Run retoc_status through your MCP client to check availability. The toolkit searches PATH, or accepts a retocPath in tool options. If unavailable, tools return guidance linking to the official download. Conversion writes to new output files and refuses overwrites.

Develop

# .NET 10 / xUnit / Microsoft.Testing.Platform
dotnet test --solution "MCP UAsset Toolkit.slnx"
dotnet test --solution "MCP UAsset Toolkit.slnx" --configuration Release

# Self-contained Windows build
dotnet publish "MCP UAsset Toolkit.csproj" -c Release -r win-x64 --self-contained true

Source/Tools defines the MCP interface; Source/Services owns asset, archive, and process operations; Source/Models holds typed inputs and session state. Tests cover asset roundtrips, atomic edits, archive workflows, tool schemas, and optional retoc execution. See development notes for fixture and build details.

Dependencies

UAssetAPI is pinned as a Git submodule; CUE4Parse and the MCP SDK are NuGet dependencies. See UAssetAPI's license and each upstream project for its licensing terms.