Unity MCP Server

What is Unity MCP Server?

Unity MCP Server is a Model Context Protocol (MCP) server that integrates the Unity game engine with AI assistants. It provides tools for building, testing, profiling, and managing Unity applications.

How to use Unity MCP Server?

Clone the repository, install dependencies with npm install, and build with npm run build. Optionally set the UNITY_EXECUTABLE environment variable. Start the server with npm start (production) or npm run dev (development). Invoke tools via the MCP protocol, including unity_execute, unity_build, unity_compile, unity_generate_csproj, unity_run_tests, unity_profile, unity_frame_debugger, unity_memory_snapshot, unity_refresh_assets, and unity_set_defines.

Key features of Unity MCP Server

• Execute Unity command-line operations
• Build Unity projects for multiple platforms
• Run Unity tests (EditMode/PlayMode)
• Capture performance profiling data
• Capture frame rendering statistics
• Analyze memory snapshots and logs

Use cases of Unity MCP Server

• Automate builds and tests from AI-assisted workflows
• Profile performance and memory usage of Unity applications
• Manage assets and scripting defines without manual Editor interaction
• Generate C# project files for IDE integration (Visual Studio, VSCode, Rider)

FAQ from Unity MCP Server

What Unity versions are supported?

Unity 2019.4 or later.

What are the runtime requirements?

Node.js 18 or higher and Unity 2019.4 or higher.

Does the server support WSL?

Yes, it fully supports WSL environments with automatic detection and path conversion.

How does the server find the Unity executable?

It auto-detects Unity installations on Windows, macOS, and Linux/WSL. The UNITY_EXECUTABLE environment variable can also be set manually.

What build platforms are supported?

StandaloneWindows64, StandaloneOSX, StandaloneLinux64, Android, iOS, and WebGL.