Skillget

unity-mcp-pro-plugin

mcp
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 16 GitHub stars
Code Pass
  • Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a Unity Editor plugin that connects AI assistants like Claude and Cursor to Unity via WebSocket. It exposes over 280 tools allowing the AI to deeply manipulate game scenes, assets, physics, and scripts directly within the editor.

Security Assessment
Overall Risk: Medium. The plugin establishes a local WebSocket connection (ports 6605–6609) and heavily modifies the Unity environment based on external commands. While the automated code scan caught no dangerous patterns and found no hardcoded secrets, this architecture fundamentally gives an external AI process extensive control over your development environment. Capabilities like input simulation, script manipulation, and build pipeline control are highly sensitive. Furthermore, you are required to build and run a secondary, closed-source MCP server component from abyo.net, meaning you must implicitly trust that external server software to route instructions safely to your editor.

Quality Assessment
The project is highly maintained, with its last push occurring today. It is fully open-source under the permissive and standard MIT license. Community trust is currently in its early stages, demonstrated by a modest 16 GitHub stars. However, the project itself is well-documented and appears to be production-ready, featuring robust engineering practices like automatic heartbeats, exponential backoff for reconnections, and survival through Unity's domain reloads.

Verdict
Use with caution; while the open-source Unity plugin itself appears safe and well-built, giving an external AI deep control over your editor via a proprietary server requires careful network isolation and trust in your specific AI configuration.
SUMMARY

147 AI tools for Unity game development via MCP (Model Context Protocol). Connect Claude, Cursor, and AI assistants to your Unity editor.

README.md

Unity MCP Pro — Plugin

Unity editor plugin that connects AI assistants (Claude, Cursor, Windsurf, VS Code Copilot) to the Unity editor via WebSocket.

280+ tools across 50 categories — scene management, GameObjects, scripts, prefabs, physics, lighting, animation, materials, terrain, particles, audio, UI, build pipeline, input simulation, screenshots, testing, 2D, timeline, splines, ECS, netcode, XR, and more.

Features

  • Full Undo/Redo — Every AI operation goes through Unity's Undo system (Ctrl+Z)
  • Production-grade WebSocket — Heartbeat, auto-reconnect with exponential backoff, port scanning (6605–6609)
  • Smart Type Parsing — Automatic conversion of strings to Vector3, Color, Quaternion, etc.
  • Domain Reload Safe — Survives script recompilation without losing connection state
  • Server Setup Window — Built-in editor window for configuring MCP server and IDE integration
  • Unity 2021.3+ — Supports Unity 2022, 2023, and Unity 6 (Built-in, URP, HDRP)

50 Tool Categories

Category # Category #
Project 7 Animation 7
Scene 6 Animation Extended 5
GameObject 11 UI (Canvas) 6
Script 6 Audio 5
Editor 5 Particle 5
Prefab 6 Navigation 5
Material & Shader 6 Terrain 4
Physics 6 Build Pipeline 5
Lighting 5 Batch Operations 6
Analysis & Profiling 10 Package Manager 6
Input Simulation 8 Debug 5
Runtime Extended 7 Screenshot & Visual 4
Testing & QA 6 2D Tools 6
Controller 4 Timeline 5
Environment 6 Spline 5
Optimization 7 Shader Graph 5
Camera / Cinemachine 6 Visual Scripting 5
Post-Processing 5 Profiler 4
AI Tools 4 Benchmark 4
Game Systems 5 Playthrough 4
Import Settings 5 Watch / Monitor 3
Multi-Scene 4 Undo History 3
Scene View Camera 4 Addressables 5
Custom Editor 4 Localization 4
Rigging 4 ECS / DOTS 4
Netcode 4 XR / VR 4

Installation

Option 1: Unity Package Manager (Git URL)

  1. Open Unity → Window → Package Manager
  2. Click + → Add package from git URL...
  3. Enter:
    https://github.com/youichi-uda/unity-mcp-pro-plugin.git

Option 2: Clone to your project

cd YourUnityProject/Packages
git clone https://github.com/youichi-uda/unity-mcp-pro-plugin.git com.unity-mcp-pro

Option 3: Download and copy

Download this repository and copy it into your project's Packages/com.unity-mcp-pro/ directory.

Setup

This plugin is the Unity-side component of Unity MCP Pro. To use it with AI assistants, you also need the MCP server.

  1. Install this plugin (see above)
  2. Get the MCP server — Available at unity-mcp.abyo.net
  3. Build the MCP server:
    cd server && npm install && npm run build
  4. Configure your AI client (or use the built-in Window → Unity MCP Pro → Server Setup):
    {
  "mcpServers": {
    "unity-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}
  5. Open Unity — The plugin auto-connects when the editor starts. Check Window → Unity MCP Pro for connection status.

Architecture

AI Assistant  ←—stdio/MCP—→  Node.js MCP Server  ←—WebSocket—→  Unity Editor Plugin (this repo)

The plugin runs a WebSocket client inside the Unity editor that connects to the MCP server on 127.0.0.1:6605–6609. All tool calls are dispatched through the CommandRouter to domain-specific command handlers.

Multi-Editor Support

Run multiple Unity editors simultaneously on ports 6605-6609. Set the UNITY_MCP_PORT environment variable to target a specific instance.

Running Tests

  1. Open Unity → Window → General → Test Runner
  2. Select EditMode tab
  3. Click Run All

Requirements

  • Unity 2021.3 LTS or later
  • Node.js 18+ (for the MCP server)
  • Any MCP-compatible AI client

Links

License

MIT License — see LICENSE

Reviews (0)

No results found