v2.0.2

README and metadata sync. No server changes.

v2.0.1 — MCP Registry support

• Added MCP Registry metadata (server.json) for publishing to registry.modelcontextprotocol.io
• Publish workflow now auto-publishes to both PyPI and MCP Registry on release
• No functional changes

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

v1.0.2

Search ranking fix — core Unity APIs now rank #1 for common queries.

• "Instantiate" → Object.Instantiate (was #4, now #1)
• "Physics Raycast" → Physics.Raycast (was #3, now #1)
• "SceneManager" → SceneManager type (was #2, now #1)
• Search top-1 accuracy: 80% → 100% on 12 common queries

Ranking uses BM25 with tuned column weights + core namespace boosting.

v1.0.1

• MIT license added
• Database expanded to 42,223 records (added UI/TMP, AI Navigation, Netcode packages)
• README rewritten with benchmarks, badges, collapsible sections
• pyproject.toml updated with full metadata

Install: pip install unity-api-mcp

v1.0.0

unity-api-mcp v1.0.0

MCP server providing ground-truth Unity 6 API documentation — prevents AI hallucination of signatures, namespaces, and deprecated APIs.

Features

• 5 tools: search_unity_api, get_method_signature, get_namespace, get_class_reference, get_deprecation_warnings
• Pre-built SQLite + FTS5 database (78K records, ~24 MB) — no Unity installation required
• Covers all UnityEngine/UnityEditor modules, Input System, Addressables

Install

pip install git+https://github.com/Codeturion/unity-api-mcp.git

Database v1 — Unity 2022 / 2023 / 6

Pre-built SQLite databases for unity-api-mcp v2.0.0+.

Downloaded automatically on first server run. No manual action needed.

File	Unity Version	Records	Size
unity_docs_2022.db	2022.3 LTS	32,000	18 MB
unity_docs_2023.db	2023.1	31,387	18 MB
unity_docs_6.db	6000.3 (Unity 6)	42,223	24 MB

Built from local Unity installations + package sources (Input System, Addressables, uGUI, TMP, AI Navigation, Netcode).