v2.0.0 — Multi-version support (Unity 2022 / 2023 / 6)

What's new

Databases are no longer bundled in the wheel. Instead, the server downloads the correct database on first run based on your Unity version. The wheel is now lightweight (~50 KB instead of ~27 MB).

Multi-version support

• Unity 2022 LTS, 2023, and Unity 6 each have their own database
• Set UNITY_VERSION in your MCP config's env block: "2022", "2023", or "6"
• Or point UNITY_PROJECT_PATH at your project and the server reads ProjectVersion.txt automatically
• Defaults to Unity 6 if nothing is set

Database stats

Version	Records	Size
Unity 2022	32,000	18 MB
Unity 2023	31,387	18 MB
Unity 6	42,223	24 MB

Updated MCP config

{
  "mcpServers": {
    "unity-api": {
      "command": "unity-api-mcp",
      "args": [],
      "env": {
        "UNITY_VERSION": "2022"
      }
    }
  }
}

Breaking changes

• The wheel no longer ships a pre-built database. First run requires internet to download (~18-24 MB, cached at ~/.unity-api-mcp/).
• python -m unity_api_mcp.ingest now requires --unity-version.

New files

• version.py — version detection + on-demand database download

Install / upgrade

pip install --upgrade unity-api-mcp