unity-mcp-codergame.md

Unity MCP by CoderGamester

MCP App · UI in chat
from"CoderGamester"
2.0k

CoderGamester maintains this community Unity Editor package and local Node MCP bridge. It exposes scene, asset, console, package and test automation tools, plus a dashboard registered at ui://unity-dashboard through @modelcontextprotocol/ext-apps.

Not for: Runtime AI inside a shipped game. This project automates and inspects the Unity Editor during development.

Source and setup verified on 2026-11-05

Gaming
UnityMCP Appseditor automationdashboard

Quick facts

Maintainer
CoderGamester (community)
Requirements
Unity 6+, Node.js 18+, npm 9+
Bridge
Node stdio MCP server to Unity WebSocket on port 8090
UI evidence
ui://unity-dashboard via @modelcontextprotocol/ext-apps
Dashboard host
VS Code 1.109+ documented

What you can do

  • Create, modify and inspect GameObjects and components
  • Manage scenes, assets, materials and packages
  • Read console logs and run Unity tests
  • Control Play Mode from the Unity dashboard
  • Batch tool operations with optional rollback

Requirements

  • Unity 6 or later
  • Node.js 18 or later
  • npm 9 or later
  • VS Code 1.109+ for the documented MCP App dashboard
setup.md
# 1. Add the Unity package

In Window → Package Manager choose Add package from git URL and enter https://github.com/CoderGamester/mcp-unity.git.

# 2. Configure the client

Open Tools → MCP Unity → Server Window and click Configure for the client. The editor writes the path to the package's built Node server.

# 3. Open the dashboard

In a compatible VS Code host, call show_unity_dashboard or use the unity_dashboard prompt.

# JSON-based MCP client → MCP client config
{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": ["ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"]
    }
  }
}

The Unity Server Window can generate the correct absolute or project-relative path automatically.

Always confirm the latest setup instructions with the maintainer before installing.

>Questions

Does MCP Unity really include an MCP App?

Yes. The source registers ui://unity-dashboard with registerAppResource and links show_unity_dashboard to it with ui.resourceUri metadata.

Why does the dashboard not open in every client?

The README specifically documents the dashboard for VS Code 1.109+. Other clients may expose the tools without rendering the app resource.

Why does Unity MCP fail from WSL2?

Unity and WSL2 may not share localhost. The README recommends mirrored networking or setting UNITY_HOST to the Windows host address.