mcp-unity
MCP Unity connects AI assistants to the Unity Editor through the Model Context Protocol. The README lists tools for manipulating and querying scenes and GameObjects: `execute_menu_item` to run any Unity menu item, `select_gameobject`, `update_gameobject` (name, tag, layer, active and static state, or create it if missing), `update_component` (change component fields or add the component), `add_package` to install packages through the Package Manager, and more, each with an example prompt such as adding a Rigidbody to the Player and setting its mass to 5. It also adds the Unity `Library/PackedCache` folder to VS Code-style IDE workspaces (VS Code, Cursor, Windsurf, Antigravity) so assistants understand package dependencies.
Installation has three steps. Install Node.js 18 or newer, then add the package in Unity's Package Manager with "Add package from git URL" and `https://github.com/CoderGamester/mcp-unity.git`, then configure your AI client either from the Unity menu (Tools > MCP Unity > Server Window > Configure) or by hand with a `node` command pointing at `Server~/build/index.js`; a Codex CLI TOML example is included. Finally you start the WebSocket server from the same window. Requirements are Unity 6 or later and Node.js 18 or later, and the README notes that paths with spaces are supported but moving the project is a fix if you see connection problems. It is MIT licensed, with English, Chinese and Japanese READMEs.
Features
Why choose it
Trade-offs
Maintenance check
- Last commit
- 2026-10-11
- Commits, last 90 days
- 13
- Releases, last 90 days
- 1
- Latest release
- 1.5.0 (2026-09-03)
- Open issues
- 7
- Recent issues with at least one comment
- 19/23
Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.
Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.
Most discussed open issues
- #141 Failed to start WebSocket server: Port <PORT NUMBER> is already in use13 comments · 2026-06-03
- #79 How to refer an gameobject as "THIS" or "THAT"5 comments · 2025-09-06
- #127 Consider listing in awesome-codex-plugins0 comments · 2026-04-01
- #125 Consider listing in awesome-codex-plugins0 comments · 2026-03-28
Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.
Compatibility
Quick start
Use cases
Alternatives
Comments
No comments yet. Be the first!