MCP 服务器

unity-super-mcp

An MCP server providing 15 tools for Unity projects, including Unity Gaming Services LiveOps (Economy, Cloud Save, Cloud Code), build-size and bloat analysis, and store-compliance checks.

README

Unity Super MCP

One MCP server for Unity Gaming Services LiveOps, build-size analysis, and store compliance.

</div>

An MCP server that gives an AI agent 15 tools over a Unity project: Unity Gaming Services LiveOps (Economy, Cloud Save, Cloud Code), build-size and bloat analysis, and store-compliance checks — one install instead of four.

Why this exists (read me first). This was built in a single sitting to win a bet — whether an agent could usefully drive UGS end-to-end. This is the receipt. I build MCP servers and agent infrastructure; I am not a game developer and this is not a pivot into games. It's here as a demonstration of MCP tool design, not a maintained product.

Built entirely through a text-only chat with a mobile AI assistant (no file uploads, no IDE), then verified: the server type-checks clean and boots. Treat it as a reference implementation.

Install

npx -y unity-super-mcp

<details> <summary><b>Client config</b> — Claude / Cursor / Windsurf</summary>

{
  "mcpServers": {
    "unity-super": {
      "command": "npx",
      "args": ["-y", "unity-super-mcp"],
      "env": {
        "UNITY_PROJECT_PATH": "/path/to/MyGame",
        "UNITY_PROJECT_ID": "your-project-id",
        "UNITY_SERVICE_KEY_ID": "your-key-id",
        "UNITY_SERVICE_SECRET": "your-secret",
        "UNITY_ENV_ID": "production"
      }
    }
  }
}

</details>

No UGS credentials? Set only UNITY_PROJECT_PATH and you still get the 7 build/compliance tools. The UGS tools report "not configured" instead of failing.

Tools

🎮 UGS LiveOps (8)

Tool	What it does
`ugs_get_project_info`	Project + environment readout
`economy_list_catalog`	List currencies, items, purchases
`economy_create_currency`	Create a currency
`economy_create_item`	Create an inventory item
`economy_create_shop`	Create a shop with items and costs
`cloudsave_get_player_data`	Read a player's Cloud Save data
`cloudcode_list_modules`	List deployed Cloud Code modules
`cloudcode_deploy_module`	Deploy a Cloud Code module

📦 Build & Ship (7)

Tool	What it does
`super_health_check`	Run this first — fans the core checks out in parallel, returns a summary + next actions
`build_get_last_report`	Top largest assets, size by extension, total project size
`build_analyze_bloat`	Duplicates, oversized files, `Resources/` abuse, unoptimized textures
`build_fix_imports`	Generates a C# editor script for texture-import fixes (or edits `.meta` directly with `apply=true`)
`assets_find_orphans`	Unreferenced-asset heuristic
`build_check_compliance`	Android target SDK, iOS, StreamingAssets bloat

Notes

super_health_check is the intended entry point: one call, whole-project readout.
assets_find_orphans is heuristic — verify with AssetDatabase.GetDependencies before deleting anything.
Requires Node 18+.