@joshuamaojh/unity-mcp

MCP server that lets Claude (Code, Desktop) drive the Unity Editor — create GameObjects, manipulate components, control play mode, read logs, and more.

Requirements

• Node.js 20+
• Unity 6000.3+ with the com.joshuamaojh.unity-mcp UPM package installed

Quick Start

1. Install the Unity package

In Window > Package Manager > Add package from git URL:

https://github.com/JoshuaMaoJH/ClaudeUnityMCP.git?path=UnityPackage

2. Configure Claude

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@joshuamaojh/unity-mcp"]
    }
  }
}

Claude Code (.mcp.json):

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@joshuamaojh/unity-mcp"]
    }
  }
}

3. Verify

Ask Claude: "Call diagnostics.ping on the unity MCP server."

Tools

22 tools across three groups:

• diagnostics — ping, status, logs (recent / clear / tail stub)
• editor — enter/exit play mode, pause/unpause, execute menu item, save scene
• scene — get hierarchy, create/find/destroy GameObject, set active, set transform, add/remove/get components, get/set component property

Full documentation: docs/tools.md

License

MIT