Unity MCP

🎮 Control Unity Editor • ⚡ Real-time automation • 🚀 AI-powered workflows

✨ What It Does

Unity MCP provides real-time control of Unity Editor via the Model Context Protocol allowing you to:

🚀 Quick Setup

📋 Prerequisites

• Node.js >= 18.0.0 - Download

• Unity 2022.3 LTS or later - Download

• Claude Desktop or any MCP client - Download

📥 Installation

⚠️ REQUIRED: You must install Unity MCP before using any of its tools.

Method 1: Automatic Setup (Recommended) ⚡

One command does everything:

✅ Installs the package ✅ Configures your MCP client automatically ✅ Ready to use immediately after restart

Method 2: Manual Setup 🛠️

If you prefer to configure manually or use a different MCP client:

Step 1: Install the package globally

Step 2: Add to your MCP client configuration

Edit your MCP client config file:

• Windows %APPDATA%\\Claude\\claude_desktop_config.json

• macOS ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux ~/.config/Claude/claude_desktop_config.json

Add this configuration:

Step 3: Restart your MCP client

🎮 Unity Editor Integration

Tell Claude to set up the integration:

This installs 8 editor scripts to Assets/Editor/UnityMCP/ including:

• HTTP server with auto-start (port 8080)

• Control Panel UI with 🟢🟠🔴⚪ status monitoring

• ScriptableObject configuration for persistent settings

• Handlers for all 30 tools

After installation:

1. Restart Unity Editor

2. Open Tools → Unity MCP → Control Panel

3. Verify 🟢 Connected status

Done! Use the Control Panel to manage settings and monitor your connection.

🛠️ Available Tools

🎯 Editor Control (7 tools)

🗺️ Scene Management (6 tools)

🧪 Testing & Play Mode (5 tools)

📦 Assets & Console (5 tools)

⚡ Advanced Tools (7 tools)

💬 Example Commands

• "Select all objects with tag 'Enemy' and align them horizontally"

• "Move the Player object to position (0, 5, 10)"

• "Distribute selected objects evenly along the x axis"

• "Find all objects with Camera component"

• "Duplicate selected object 5 times"

• "Enter play mode and move Player to (10, 0, 0) for 5 seconds"

• "Set time scale to 0.5 for slow motion"

• "Run a test that destroys the Boss after 2 seconds"

• "Check play mode status and show test logs"

• "List all scenes in the project"

• "Load the MainMenu scene"

• "Show me the complete hierarchy of the current scene"

• "Find all objects with Rigidbody component"

• "Clean up scene by removing missing scripts"

🎛️ Unity Control Panel

Once installed, access the Control Panel via Tools → Unity MCP → Control Panel.

Features:

• 🟢 Real-time Status Monitoring

  • 🟢 Connected - Server running normally

  • 🟠 Starting - Server is initializing

  • 🔴 Error - Connection failed

  • ⚪ Disconnected - Server stopped

• ⚙️ Server Settings (Collapsable)

  • Port configuration (default: 8080)

  • Auto-start on Unity load

  • Request timeout settings

  • Remote connections (⚠️ use with caution)

• ✨ Features (Collapsable)

  • Console monitoring (max logs configurable)

  • Auto-refresh assets on changes

  • Verbose logging for debugging

• ⚡ Quick Actions (Collapsable)

  • 📋 View Console Logs

  • 🔄 Refresh Assets

  • 💾 Save Scene

  • 🧹 Clear Console

  • 📁 Open Config

  • 📖 Documentation

• 🔧 Tools Overview (Collapsable)

  • View all 30 available tools categorized by type

  • Quick reference without leaving Unity

• ⚡ Advanced Settings (Collapsable)

  • Undo/Redo support

  • Auto-backup scenes

  • Reset to defaults

Configuration is stored as a ScriptableObject: Assets/Editor/UnityMCP/Resources/MCPConfig.asset

All settings persist across Unity sessions!

🐛 Troubleshooting

MCP Server Not Showing:

1. Verify Node.js is installed: node --version

2. Check config file path is correct

3. Ensure JSON syntax is valid

4. Restart MCP client completely

Unity Editor Not Responding:

1. Ensure Unity Editor is open

2. Check Assets/Editor/UnityMCP/ scripts are installed

3. Verify Console for [Unity MCP] Server started on port 8080

4. Check no errors in Unity Console

Port Already in Use:

1. Default port is 8080

2. Check what's using it: lsof -i :8080 (Mac/Linux) or netstat -ano | findstr :8080 (Windows)

3. Stop conflicting process or change port in Unity scripts

🌱 Support & Contributions

⭐ Star the repo & I power up like Mario 🍄
☕ Devs run on coffee -
💰 Crypto tips welcome - Tip in crypto
🤝 Contributions are welcome - , improve, PR!
🎥 Need help? •

💖 Sponsor

Your support helps maintain and improve the tool. please consider .

Made with ❤️ for Game Devs • Privacy Policy • Terms of Service