UAsset Reference MCP

Tools -> UAsset Reference MCP

UAsset Reference MCP is a Unity-only asset reference graph tool. It scans a Unity project that uses text serialization, reads .meta GUIDs and YAML asset references, stores the result in SQLite, and exposes the graph through a command-line indexer, an MCP server, and a local web viewer.

The asset answers questions that are expensive to resolve manually in a large Unity project. Before changing a material, prefab, scene, or Addressables entry, you can ask what references it, what it depends on, whether it is only reachable through Addressables, and whether the graph contains broken references.

What It Builds

The indexer writes .asset-memory/index.db inside the Unity project. That database contains assets, edges, unresolved references, Addressables groups, Addressables entries, labels, and index metadata. The format is intentionally plain SQLite so the data can be inspected outside the MCP server.

The MCP server gives agents a curated query surface instead of raw SQL. Tools include index_project, find_references, get_dependencies, trace_path, find_unused_assets, search_assets, Addressables lookup tools, graph export, and verification against a Unity-side export.

Why It Exists

Unity already stores stable asset identity through .meta GUIDs, and text-serialized assets declare references as {fileID, guid, type} records. UAsset Reference MCP uses that existing structure instead of trying to infer references from code or editor state.

That makes the graph useful for impact analysis, unused-asset review, dependency tracing, broken-reference detection, and AI agent context. It does not try to solve every Unity loading path. Code-based references such as Resources.Load("path") and hard-coded Addressables strings are outside the first static graph model.

Install

npm install -g unity-asset-reference-mcp

The package exposes three commands:

Series

• Part 1 - Jul 8, 2026 - UAsset Reference MCP: Building a Unity Asset Reference Graph

• Part 2 - Jul 21, 2026 - UAsset Reference MCP: Modeling Unity Addressables Separately

Source

• GitHub repository
• npm package