Submit
codemaestroai

Unity MCP

Community codemaestroai
Updated

Public repository for Advanced Unity MCP by Code Maestro (www.code-maestro.com).

Unity MCP

Control Unity with AI through natural language commands.

Instead of clicking through menus and manually setting up GameObjects, just tell your AI assistant what you want and watch it happen automatically.

"Create a red material and apply it to a cube"
"Build the project for Android" 
"Make a new scene with a camera and directional light"

Quick Start

1. Install the Package

Unity Package Manager → Add package from git URL:

https://github.com/codemaestroai/advanced-unity-mcp.git

2. Connect Your AI

  • Go to Code Maestro > MCP Dashboard in Unity
  • Click Configure next to your preferred AI client
  • Start giving commands!

Supported AI Clients: Code Maestro, GitHub Copilot, Cursor, Windsurf, Claude Code

What Unity MCP Can Do

Core Editor Control - Play/pause/stop game, execute menu items, read/clear console messages Asset & Scene Management - Create/modify/delete materials, prefabs, scripts, manage scenes and GameObjects Build & Platform Tools - Build settings, platform switching, Android Debug Bridge operations Project Configuration - Unity packages, project settings, PlayerPrefs, external tools Performance Analysis - Unity Profiler control for performance bottlenecks

Examples

  • "Check the console for any errors"
  • "Create a script called PlayerMovement with WASD controls"
  • "Switch the build target to iOS"
  • "Add a rigidbody component to the selected object"
  • "Create a new material with metallic properties"
  • "Save the current GameObject as a prefab"
  • "Clear all console messages and check for warnings"

How It Works

Unity MCP bridges your Unity Editor with AI assistants using the Model Context Protocol. Two components work together:

  • Bridge Server - Runs in Unity, provides API access
  • Relay Server - Handles communication with AI clients

The setup is automatic once you install the package and configure your AI client.

Requirements

  • Unity 2022+
  • MCP-compatible AI client (Such as GitHub Copilot or Cursor)
  • Python 3.12+ and UV package manager installed and configured in the environment path

Troubleshooting

Installing Python and UV

Windows:

  1. Download Python from python.org
  2. During installation, check "Add Python to PATH"
  3. Open Command Prompt and run: 
    # Verify Python is installed
python --version

# Install UV
pip install uv

macOS:Install Python using Homebrew:

# Install Homebrew if not already installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Python
brew install [email protected]

# Install UV
pip3 install uv

Linux:

# Ubuntu/Debian
sudo apt update
sudo apt install python3.12 python3-pip

# Install UV
pip3 install uv

Verify Installation

Open a terminal and run:

python --version  # Should show Python 3.12+
uv --version     # Should show UV version

Common Issues

"python is not recognized" error:

  • Make sure Python is added to your system PATH
  • On Windows, restart your computer after installation
  • On macOS/Linux, restart your terminal

"uv is not recognized" error:

  • Install UV with: pip install uv or pip3 install uv
  • On Windows, you may need to add Python Scripts folder to PATH:C:\Users\[YourUsername]\AppData\Local\Programs\Python\Python312\Scripts

Permission errors on macOS/Linux:

  • Use pip3 install --user uv to install for current user only

Made by Code Maestro • Join our Discord • Report Issues

MCP Server · Populars

MCP Server · New