{"_id":"unity-asset-reference-mcp","_rev":"6-7e59fd14a26f83952a7b8bfcc1b6000b","name":"unity-asset-reference-mcp","dist-tags":{"latest":"0.4.0"},"versions":{"0.1.0":{"name":"unity-asset-reference-mcp","version":"0.1.0","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"author":{"name":"JVinceW"},"license":"MIT","_id":"unity-asset-reference-mcp@0.1.0","maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"bin":{"unity-asset-reference-mcp":"dist/mcp/server.js","unity-asset-reference-mcp-web":"dist/web/server.js","unity-asset-reference-mcp-index":"dist/cli/main.js"},"dist":{"shasum":"e7010719bb6aaa965af34b56402b34b8746c495d","tarball":"https://registry.npmjs.org/unity-asset-reference-mcp/-/unity-asset-reference-mcp-0.1.0.tgz","fileCount":98,"integrity":"sha512-5LYq8QozTM9Y1qx6YOoZeg6y7IqHKdWL1qBEJeT0dFdV7VvK5Iz6kndyfNVl73gOrmEmoe1spCuuzVl8RHwhlA==","signatures":[{"sig":"MEUCIQCxamRS6uZIgW5uwJBDIhbp00KZUfX+WBKoBjD7mCNi+QIgA69Md1v3AzXqTtl4nnYOmsZXgspfozcQPmopMWATaCo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1328757},"type":"module","engines":{"node":">=20"},"gitHead":"1fab9a83326976bca343d2c797a1d771e994e430","scripts":{"web":"node dist/web/server.js","test":"vitest run","build":"tsc -p tsconfig.build.json && node scripts/copy-public.mjs","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"jvincew","email":"vincewang10a7@gmail.com"},"repository":{"url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^4.4.3","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"sql.js":"^1.14.1","vitest":"^2.1.0","cytoscape":"^3.34.0","typescript":"^5.7.0","@types/node":"^22.10.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/unity-asset-reference-mcp_0.1.0_1783502944646_0.6592940220269692","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"unity-asset-reference-mcp","version":"0.2.0","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"author":{"name":"JVinceW"},"license":"MIT","_id":"unity-asset-reference-mcp@0.2.0","maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"bin":{"unity-asset-reference-mcp":"dist/mcp/server.js","unity-asset-reference-mcp-web":"dist/web/server.js","unity-asset-reference-mcp-index":"dist/cli/main.js"},"dist":{"shasum":"004e5fe854f8ad4db2df9c6d87897e8f46aacfc6","tarball":"https://registry.npmjs.org/unity-asset-reference-mcp/-/unity-asset-reference-mcp-0.2.0.tgz","fileCount":104,"integrity":"sha512-XVhIZQX685cnF0punB4b1mVJw9in7GENUGq1ZeMKYTeDWi+9w5zamqprGHszSrCmKxzGpKJCPZHL1y0fErlk2w==","signatures":[{"sig":"MEUCIQC9ZW4/jIpdEFd03FMChD8iCUbj9usPH4PtAUrQQBrQogIgIGGLYNa4qT0pyYyoLhNcpp4fLYRXjC1l7HPj+YxR8qg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/unity-asset-reference-mcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1351460},"type":"module","engines":{"node":">=20"},"gitHead":"b752796fef74459663f9b0bfd7dd293082d5f243","scripts":{"web":"node dist/web/server.js","test":"vitest run","build":"tsc -p tsconfig.build.json && node scripts/copy-public.mjs","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"jvincew","email":"vincewang10a7@gmail.com"},"repository":{"url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"zod":"^4.4.3","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"sql.js":"^1.14.1","vitest":"^2.1.0","cytoscape":"^3.34.0","typescript":"^5.7.0","@types/node":"^22.10.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/unity-asset-reference-mcp_0.2.0_1783507813147_0.5205028073061582","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"unity-asset-reference-mcp","version":"0.3.0","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"author":{"name":"JVinceW"},"license":"MIT","_id":"unity-asset-reference-mcp@0.3.0","maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"bin":{"unity-asset-reference-mcp":"dist/mcp/server.js","unity-asset-reference-mcp-web":"dist/web/server.js","unity-asset-reference-mcp-index":"dist/cli/main.js"},"dist":{"shasum":"78e149ec7440ffb7abe145ef88399a1b20489ff7","tarball":"https://registry.npmjs.org/unity-asset-reference-mcp/-/unity-asset-reference-mcp-0.3.0.tgz","fileCount":119,"integrity":"sha512-pi1jJ7GXDTcOrm1u6Sss+sSeIiRlktcb/i108VpSL+qng4D4gWV8SRjBpe9yzAV3cm7H+eirKSwfdayDk4o+xw==","signatures":[{"sig":"MEUCIELps9LsPgjKZQlGKnI47aZP4fR6oKJn3cHsEuhiFx4XAiEA5W0ZlamWQ71gS8gqHuW64431918EezY9i+7SapEe9R8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/unity-asset-reference-mcp@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1422506},"type":"module","engines":{"node":">=20"},"gitHead":"6d38308675e6e4883234a010c22edb77a9c1de39","scripts":{"web":"node dist/web/server.js","test":"vitest run","build":"tsc -p tsconfig.build.json && node scripts/copy-public.mjs","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"jvincew","email":"vincewang10a7@gmail.com"},"repository":{"url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","directories":{},"_nodeVersion":"22.23.1","allowScripts":{"esbuild@0.21.5":true,"better-sqlite3@12.11.1":true},"dependencies":{"zod":"^4.4.3","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"sql.js":"^1.14.1","vitest":"^2.1.0","cytoscape":"^3.34.0","typescript":"^5.7.0","@types/node":"^22.10.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/unity-asset-reference-mcp_0.3.0_1784658307045_0.5651239473012719","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"unity-asset-reference-mcp","version":"0.3.1","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"author":{"name":"JVinceW"},"license":"MIT","_id":"unity-asset-reference-mcp@0.3.1","maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"bin":{"unity-asset-reference-mcp":"dist/mcp/server.js","unity-asset-reference-mcp-web":"dist/web/server.js","unity-asset-reference-mcp-index":"dist/cli/main.js"},"dist":{"shasum":"2bba092ad0d0b0b95fab48c52b1bfd7604025a69","tarball":"https://registry.npmjs.org/unity-asset-reference-mcp/-/unity-asset-reference-mcp-0.3.1.tgz","fileCount":122,"integrity":"sha512-OcQrr5xzFjJnskpG6CpXnxLk2/7F9n0rFOdZvH5TRQkqsvMsgdtTrJOSE04dacsTkr9urame6zASGTKEshquNA==","signatures":[{"sig":"MEUCIQC5tWKFYEy6ds+nepM6jmcllFG3Ezv3OVbKLCGwYG92ygIgXgbn6ZcQIIZIN3DddGAQ2vouHt6M+7phfuNVM87Phx4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/unity-asset-reference-mcp@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1433817},"type":"module","engines":{"node":">=20"},"gitHead":"c6a6ae25b198b5beccd608d925c38b4c4b16dc67","scripts":{"web":"node dist/web/server.js","test":"vitest run","build":"tsc -p tsconfig.build.json && node scripts/copy-public.mjs","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"jvincew","email":"vincewang10a7@gmail.com"},"repository":{"url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","directories":{},"_nodeVersion":"22.23.1","allowScripts":{"esbuild@0.21.5":true,"better-sqlite3@12.11.1":true},"dependencies":{"zod":"^4.4.3","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"sql.js":"^1.14.1","vitest":"^2.1.0","cytoscape":"^3.34.0","typescript":"^5.7.0","@types/node":"^22.10.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/unity-asset-reference-mcp_0.3.1_1784780049834_0.33928775465923366","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"unity-asset-reference-mcp","version":"0.3.2","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"author":{"name":"JVinceW"},"license":"MIT","_id":"unity-asset-reference-mcp@0.3.2","maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"bin":{"unity-asset-reference-mcp":"dist/mcp/server.js","unity-asset-reference-mcp-web":"dist/web/server.js","unity-asset-reference-mcp-index":"dist/cli/main.js"},"dist":{"shasum":"e495ee07b847958b9ad6b2bcc5869f9622f494fc","tarball":"https://registry.npmjs.org/unity-asset-reference-mcp/-/unity-asset-reference-mcp-0.3.2.tgz","fileCount":125,"integrity":"sha512-ao9PNNQ+7672W1kKXq6FW2lPd0n4YWiFBrdJkXKHs4nziO2/nt1dFom7/QaBz+YqA07aofiJy3DjfopDXf8hjQ==","signatures":[{"sig":"MEQCIECt/ditCJQ0KHpEDVTxbsKMws+pGOWawLXrrmeYyBWsAiAfidgviWQ2jUQOCkod2c27enCNcQ5mSfU7G1r15B9jeA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/unity-asset-reference-mcp@0.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1453656},"type":"module","engines":{"node":">=20"},"gitHead":"e717b3f422b0df4ddba91d5401276ed017bc0cd1","scripts":{"web":"node dist/web/server.js","test":"vitest run","build":"tsc -p tsconfig.build.json && node scripts/copy-public.mjs","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"jvincew","email":"vincewang10a7@gmail.com"},"repository":{"url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git","type":"git"},"_npmVersion":"10.9.8","description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","directories":{},"_nodeVersion":"22.23.1","allowScripts":{"esbuild@0.21.5":true,"better-sqlite3@12.11.1":true},"dependencies":{"zod":"^4.4.3","better-sqlite3":"^12.11.1","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"sql.js":"^1.14.1","vitest":"^2.1.0","cytoscape":"^3.34.0","typescript":"^5.7.0","@types/node":"^22.10.0","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/unity-asset-reference-mcp_0.3.2_1784832747206_0.7698663999180333","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"unity-asset-reference-mcp","version":"0.4.0","type":"module","description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"license":"MIT","author":{"name":"JVinceW"},"repository":{"type":"git","url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git"},"homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"bin":{"unity-asset-reference-mcp":"dist/mcp/server.js","unity-asset-reference-mcp-index":"dist/cli/main.js","unity-asset-reference-mcp-web":"dist/web/server.js"},"scripts":{"test":"vitest run","test:watch":"vitest","benchmark:indexer":"node scripts/benchmark-indexer.mjs","typecheck":"tsc --noEmit && tsc -p tsconfig.viewer.json --noEmit","build:viewer":"vite build --config vite.viewer.config.ts","build:static-viewer":"node scripts/build-static-viewer.mjs","build:unity-artifacts":"node scripts/build-unity-artifacts.mjs","build":"tsc -p tsconfig.build.json && npm run build:viewer && node scripts/copy-public.mjs","web":"node dist/web/server.js","prepublishOnly":"npm run build"},"engines":{"node":">=20"},"devDependencies":{"@fontsource/ibm-plex-mono":"^5.3.0","@fontsource/ibm-plex-sans":"^5.3.0","@react-three/fiber":"9.7.0","@tanstack/react-query":"^5.101.4","@tanstack/react-table":"^8.21.3","@tanstack/react-virtual":"^3.14.9","@types/better-sqlite3":"^7.6.13","@types/node":"^22.10.0","@types/react":"^19.2.18","@types/react-dom":"^19.2.4","@types/three":"0.185.3","@vitejs/plugin-react":"^4.7.0","cytoscape":"^3.34.0","graphology":"^0.26.0","graphology-layout-forceatlas2":"^0.10.1","lucide-react":"^1.28.0","react":"^19.2.8","react-dom":"^19.2.8","sigma":"^3.0.3","sql.js":"^1.14.1","three":"0.185.1","typescript":"^5.7.0","vite":"^5.4.21","vitest":"^2.1.0","zustand":"^5.0.14"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","better-sqlite3":"^12.11.1","zod":"^4.4.3"},"allowScripts":{"better-sqlite3@12.11.1":true,"esbuild@0.21.5":true},"_id":"unity-asset-reference-mcp@0.4.0","gitHead":"3c8d3367957ca49ad9ccfe105b8c72af00ffd7a5","_nodeVersion":"22.23.2","_npmVersion":"10.9.8","dist":{"integrity":"sha512-mAvcTilbKadKnodtPstFoS9kmfwpHf3H760MubggXgI+havQXfdA9i/7iHYl8sy0Fw36Xb0jk+Q+CPHNcSnCiA==","shasum":"8bb99111b227d8b45bed4768fb9bb8bca50f3eec","tarball":"https://registry.npmjs.org/unity-asset-reference-mcp/-/unity-asset-reference-mcp-0.4.0.tgz","fileCount":147,"unpackedSize":2159965,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/unity-asset-reference-mcp@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCyq/Pmlm9oCJ7qEvGWPorX6EnzMuJl5NUBomvg1EB72gIgToTY2QgwTr6BE07HcXtJn9bHe36FYskjQ5dGKxwKKvI="}]},"_npmUser":{"name":"jvincew","email":"vincewang10a7@gmail.com"},"directories":{},"maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/unity-asset-reference-mcp_0.4.0_1787504027276_0.28738623516795325"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-08T09:29:04.546Z","modified":"2026-08-23T16:53:47.793Z","0.1.0":"2026-07-08T09:29:04.877Z","0.2.0":"2026-07-08T10:50:13.312Z","0.3.0":"2026-07-21T18:25:07.223Z","0.3.1":"2026-07-23T04:14:10.019Z","0.3.2":"2026-07-23T18:52:27.381Z","0.4.0":"2026-08-23T16:53:47.484Z"},"bugs":{"url":"https://github.com/JVinceW/uasset-reference-memory-mcp/issues"},"author":{"name":"JVinceW"},"license":"MIT","homepage":"https://github.com/JVinceW/uasset-reference-memory-mcp#readme","keywords":["unity","mcp","model-context-protocol","addressables","asset","dependency-graph","unused-assets","impact-analysis","gamedev"],"repository":{"type":"git","url":"git+https://github.com/JVinceW/uasset-reference-memory-mcp.git"},"description":"Index a Unity project's assets into a reusable SQLite reference graph — impact analysis, unused-asset detection, dependency tracing, and an MCP server + web viewer. Unity-only.","maintainers":[{"name":"jvincew","email":"vincewang10a7@gmail.com"}],"readme":"# unity-asset-reference-mcp\n\n[![CI](https://github.com/JVinceW/uasset-reference-memory-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/JVinceW/uasset-reference-memory-mcp/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/unity-asset-reference-mcp)](https://www.npmjs.com/package/unity-asset-reference-mcp)\n\nIndex a **Unity** project's assets into a reusable **SQLite reference graph**, then\nquery it three ways: a **CLI**, an **MCP server** (for Claude and other agents),\nand a local **web viewer**. Unity-only.\n\n- **Impact analysis** — \"what references this material?\" before you change it\n- **Unused-asset detection** — orphans nothing loads (Addressables-aware)\n- **Dependency tracing** — the full closure a scene/prefab pulls in\n- **Broken-reference detection** — refs to deleted/missing assets\n- **Reusable artifact** — a plain `.sqlite` any tool can open; no lock-in\n\nIt reads Unity's own serialization (`.meta` GUIDs + YAML `{fileID, guid}` refs),\nso the graph is exact — no heuristics, no AST. Requires **Asset Serialization:\nForce Text** (Unity's default for version control).\n\n## Requirements\n\n- Node.js ≥ 20\n- A Unity project using **Force Text** serialization\n- `better-sqlite3` builds via prebuilt binaries during install (native module)\n\n## Install\n\n```bash\nnpm install -g unity-asset-reference-mcp\n```\n\nPrereleases publish under the `next` dist-tag, so `latest` always resolves to\nthe current stable release. To try a release candidate:\n\n```bash\nnpm install -g unity-asset-reference-mcp@next\nsh scripts/install.sh --package unity-asset-reference-mcp@next\n```\n\n### Upgrading\n\nFrom **0.3.x** there is nothing to do. The index schema is unchanged at version\n3, so an existing `<project>/.asset-memory/index.db` is read as-is — no reindex,\nno config change.\n\nFrom **0.2.x** the index must be rebuilt from schema 2 to 3. The indexer detects\nthis and rebuilds on the next `index_project` or `index` run; no flag or manual\nmigration is needed. Until then, MCP read tools return a `schema-mismatch` error\nnaming the fix rather than answering from an incompatible index.\n\nTwo behavior changes to expect when upgrading to 0.4.0:\n\n- The viewer served at `/` is the new one; the previous viewer moved to\n  `/legacy.html`.\n- `search_assets` (and `/api/search`) now match an asset's path and GUID prefix\n  as well as its name, so the same query returns more results than in 0.3.2.\n\nInstaller scripts are also available for users who prefer one command with\nNode/npm checks and command verification:\n\n```bash\n# Linux/macOS, from a cloned repo\nsh scripts/install.sh\n\n# Linux/macOS, from GitHub\ncurl -fsSL https://raw.githubusercontent.com/JVinceW/uasset-reference-memory-mcp/main/scripts/install.sh | sh\n```\n\n```powershell\n# Windows PowerShell, from a cloned repo\npowershell -ExecutionPolicy Bypass -File .\\scripts\\install.ps1\n\n# Windows PowerShell, from GitHub\nirm https://raw.githubusercontent.com/JVinceW/uasset-reference-memory-mcp/main/scripts/install.ps1 | iex\n```\n\nThis puts three commands on your `PATH`:\n\n| Command | What |\n| --- | --- |\n| `unity-asset-reference-mcp-index` | the CLI indexer |\n| `unity-asset-reference-mcp` | the MCP server |\n| `unity-asset-reference-mcp-web` | the web viewer |\n\n**Without a global install (npx):** the MCP server's bin name matches the package,\nso `npx -y unity-asset-reference-mcp …` works directly. For the other two bins,\nname the package with `-p`:\n\n```bash\nnpx -y unity-asset-reference-mcp --project /path/to/UnityProject          # MCP server\nnpx -y -p unity-asset-reference-mcp unity-asset-reference-mcp-index index /path   # indexer\nnpx -y -p unity-asset-reference-mcp unity-asset-reference-mcp-web --project /path # viewer\n```\n\n## 1. Index a project\n\nBuilds `<project>/.asset-memory/index.db`.\n\n```bash\nunity-asset-reference-mcp-index index /path/to/UnityProject --force\n```\n\nIndexing uses bounded concurrency for filesystem scanning and YAML reference\nextraction. The default is capped at eight workers; adjust it for a benchmark\nor storage device with `--concurrency <n>`. SQLite graph writes remain\ntransactional and serialized:\n\n```bash\nunity-asset-reference-mcp-index index /path/to/UnityProject --concurrency 4\n```\n\nAdd this to your **Unity project's** `.gitignore` — ignore the live index, but\ncommit the config and (optional) shared snapshot:\n\n```gitignore\n# unity-asset-reference-mcp: ignore the live index, keep config + shared snapshot\n.asset-memory/index.db\n.asset-memory/index.db-*\n.asset-memory/*.building-*\n.asset-memory/verify.json\n.asset-memory/verify-report.json\n```\n\n## 2. Verify parser accuracy (optional)\n\nVerification is a manual accuracy check. The Unity Editor exporter installs\nseparately from the Node tool, so neither requires the other. It is versioned on\nits own cadence and is **not** part of the npm package.\n\nPick whichever install suits your team — all four deliver the same package:\n\n| Method | How |\n| --- | --- |\n| **Git URL** | Package Manager → **Add package from git URL** |\n| **Tarball** | download the `.tgz`, then **Add package from tarball** |\n| **Folder** | download and unzip the `.zip`, then **Add package from disk** → pick `package.json` |\n| **`.unitypackage`** | download, then **Assets → Import Package → Custom Package** |\n\n```text\nhttps://github.com/JVinceW/uasset-reference-memory-mcp.git?path=/unity/com.jvincew.assetreferencememory#<release-tag>\n```\n\nThe `.tgz`, `.zip`, and `.unitypackage` downloads are attached to each\n[release](https://github.com/JVinceW/uasset-reference-memory-mcp/releases).\n\nThe first three install it as a Package Manager package under `Packages/`, which\nis upgradable in place. The `.unitypackage` instead imports the files into\n`Assets/AssetReferenceMemory/`, where Unity does not track it as a package — so\nupgrading means deleting that folder before importing a newer one. Prefer one of\nthe first three unless your workflow requires assets in the project tree.\n\nIn Unity, run **Tools > Asset Reference Memory > Export Verification**. It\nwrites `<project>/.asset-memory/verify.json`. Compare that export with the\nindex through the CLI:\n\n```bash\nunity-asset-reference-mcp-index verify-index /path/to/UnityProject \\\n  --verify /path/to/UnityProject/.asset-memory/verify.json\n```\n\nThe command exits successfully when differences are found. It prints a bounded\nsummary and writes every missed/extra edge to\n`<project>/.asset-memory/verify-report.json`. MCP clients use\n`verify_index(verifyJsonPath)` and receive the same summary plus the report\npath.\n\n## 3. MCP server (works with any MCP client)\n\nThis is a standard **stdio MCP server** — it works with any MCP-compatible host:\nClaude Code/Desktop, Cursor, Windsurf, Cline, VS Code (Copilot agent), Zed, and\nothers. Nothing is Claude-specific; only where you put the config differs.\n\n**Generic config** (Claude Desktop, Cursor, Windsurf, Cline, and most hosts use\nthis `mcpServers` shape):\n\n```json\n{\n  \"mcpServers\": {\n    \"unity-asset-graph\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"unity-asset-reference-mcp\", \"--project\", \"/path/to/UnityProject\"]\n    }\n  }\n}\n```\n\nWhere that config lives, per host:\n\n| Host | Config location |\n| --- | --- |\n| Claude Code | `claude mcp add unity-asset-graph -- npx -y unity-asset-reference-mcp --project /path/to/UnityProject` (or `.mcp.json` in the project) |\n| Claude Desktop | `claude_desktop_config.json` |\n| Cursor | `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global) |\n| Windsurf | `~/.codeium/windsurf/mcp_config.json` |\n| Cline | `cline_mcp_settings.json` |\n| VS Code (Copilot) | `.vscode/mcp.json` — uses the key `servers` instead of `mcpServers` |\n\n**Prerequisites:** Node ≥ 20 on `PATH` (for `npx`), and a Unity project on Force\nText serialization. You do **not** need to pre-index — call the `index_project`\ntool once from the agent and it builds `<project>/.asset-memory/index.db`; the\nread tools return a clear `no-index` error until you do.\n\n**Tools exposed:** `index_project`, `index_status`, `get_dependencies`,\n`find_references`, `find_unused_assets`, `trace_path`, `search_assets`,\n`get_addressable_info`, `search_addressables`, `list_addressable_groups`,\n`get_overview`, `get_edges`, `verify_index`, `export_graph_json`, and\n`manage_adr`.\n\nThe Addressables tools provide read-only entry lookup, filtered discovery, and\ngroup inventory. `indexedSourceBytes` is source-file size, not built bundle\nsize, and `reachableOnlyBecauseAddressable` is a review signal rather than\ndeletion safety. See\n[docs/product/addressables.md](docs/product/addressables.md).\n\nIndexing follows Unity's identity model: an asset and its sibling `.meta` are\none logical row, the GUID is stable identity, and the path is mutable. A normal\nincremental refresh observes the newer asset/`.meta` modification time and\ntreats a GUID at a new path as one update. A new GUID at an old path is reported\nas removal plus addition with a `guid-replaced` warning. Missing, orphaned, or\ninvalid `.meta` state is warned and skipped until Unity or source control\nrestores a complete pair; duplicate GUIDs stop the refresh without replacing\nthe last good index.\n\n**Agent refresh policy:** before the first graph-dependent operation when\nfreshness is unknown, call `index_project` once in incremental mode. Reuse that\nindex for subsequent read-only queries, then refresh once after each coherent\nbatch of asset/`.meta` changes. Use `force: true` only when guaranteed freshness\nis required. `index_status` reports stored index metadata; it does not scan live\nassets or prove freshness, and query tools never trigger hidden indexing.\n\n## 4. Web viewer\n\n```bash\ncd /path/to/UnityProject\nunity-asset-reference-mcp-web\n# asset graph viewer → http://localhost:7777\n```\n\nRun from anywhere inside a Unity project and the server finds the project root\nby walking up, the way `git` locates a repository. Name one explicitly with\n`--project <root>` — the same argument the MCP server and indexer take — or\npoint at a database elsewhere with `--db <index.db>`.\n\nThe port is chosen automatically: it starts at 7777 and moves to the next free\none, so several projects can be served at once without configuring anything.\nPin one with `--port <n>`; if that port is busy the server reports the port it\nused instead of failing. The URL it prints is always the real one.\n\nThe viewer renders the dependency graph in **2D or 3D**, with an attention panel\nfor broken references, unused assets, and the most-referenced assets; filters by\nasset type and origin; dependency/reference tracing; search; and back/forward\nnavigation. It reads the index through the same JSON API the server exposes.\n\nThe previous Cytoscape viewer is still bundled at\n**`http://localhost:7777/legacy.html`**.\n\nThere is also a **static** flavor that needs no server at all: download\n`asset-graph-viewer-static-<version>.zip` from the\n[releases page](https://github.com/JVinceW/uasset-reference-memory-mcp/releases),\nunzip it, open `viewer.html` in a browser, and pick a `.db`. It runs the same\nqueries entirely in-browser via WASM SQLite. It ships as a separate download\nrather than inside the npm package so that every install does not carry ~700 KB\nof WASM it will never load; all flavors share one query layer.\n\n## Team sharing (snapshots)\n\nInstead of every teammate re-indexing from scratch, commit a **compressed\nsnapshot** and let them restore it — the same idea as `codebase-memory`'s\n`.codebase-memory/`.\n\n```bash\n# after indexing, export a shareable snapshot (or pass --snapshot to `index`)\nunity-asset-reference-mcp-index snapshot /path/to/UnityProject\n# -> .asset-memory/index.db.br  (brotli, ~85% smaller) + artifact.json + .gitattributes\n\n# a teammate who clones + pulls restores the live index with no re-index:\nunity-asset-reference-mcp-index restore /path/to/UnityProject\n```\n\nThe MCP server and web viewer **auto-restore** from a snapshot on first use if the\nlive index is missing, so a fresh clone \"just works\". **Commit** these:\n\n```\n.asset-memory/config.json       # per-project settings (below)\n.asset-memory/index.db.br       # compressed shared index\n.asset-memory/artifact.json     # snapshot metadata (schema, commit, counts)\n.asset-memory/.gitattributes    # marks the blob binary + merge=ours\n```\n\n`artifact.json` records the git commit and counts the snapshot was built at, so\nyou can tell when it's stale and re-run `index --snapshot`.\n\n## Configuration\n\nOptional per-project `.asset-memory/config.json` (see\n[docs/product/configuration.md](docs/product/configuration.md)):\n\n```json\n{\n  \"unused\": { \"addressableRoots\": \"auto\" },\n  \"scan\":   { \"ignore\": [\"**/ThirdParty/**\", \"*.bak\"], \"ignoreDefaults\": true }\n}\n```\n\n- `unused.addressableRoots` (`auto`\\|`on`\\|`off`) — count Addressable entries as\n  roots for unused detection (query-time; `auto` = on if the project uses\n  Addressables). Overridable per call.\n- `scan.ignore` / `scan.ignoreDefaults` — extra ignore globs (index-time).\n\n## The SQLite artifact\n\nOpen `.asset-memory/index.db` with any SQLite tool. Core tables: `assets`\n(nodes), `edges` (references), `unresolved_refs` (broken refs),\n`addressable_groups`, `addressable_entries`, `addressable_entry_labels`, and\n`index_meta`. Schema:\n[docs/product/asset-graph-model.md](docs/product/asset-graph-model.md).\n\nSchema 3 normalizes Addressables into `addressable_groups`,\n`addressable_entries`, and `addressable_entry_labels`. JSON exports include\neach entry's read-only state, owning group identity, and sorted labels. Older\ngenerated indexes and snapshots must be rebuilt with `index_project`; they are\nnot migrated in place.\n\n## Known limitations\n\n- **Code-based refs not tracked**: `Resources.Load(\"path\")` and hard-coded\n  Addressable address strings in C# aren't scanned yet, so `find_unused` output\n  is *candidates* — verify against your loading code.\n- **Asset-level granularity**: edges are asset→asset (not per-GameObject/fileID).\n- **Read-only Addressables Stage 1**: group schemas, profiles, providers,\n  packing/compression, build/load paths, content-update settings, and bundle\n  analysis are deferred.\n- Incremental re-index uses filesystem modification times for speed and can\n  miss timestamp-preserving edits. Use `--force` for a guaranteed-freshness\n  rebuild from current readable project contents; it still reports unreadable\n  or incomplete project state rather than modifying Unity assets.\n\n## Development\n\n```bash\nnpm install\nnpm test        # vitest\nnpm run build   # tsc + Vite viewer bundle + copy web assets to dist/\nnpm run benchmark:indexer  # controlled 2,000-asset concurrency benchmark\n```\n\nThis repo uses a Git-native, text-first development workflow (see\n[docs/WORKFLOW.md](docs/WORKFLOW.md)); it is not part of the shipped package.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","readmeFilename":"README.md"}