Unity Editor MCP Server
Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs
What is Unity Editor MCP Server?
Unity Editor MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) plugin to connect with unity editor — designed for cursor, claude code, codex, windsurf and other ides
Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Model Context Protocol (MCP) plugin to connect with Unity Ed
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx unity-editor-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Unity Editor MCP Server
Unity Editor MCP Server is a Model Context Protocol plugin that creates a live bridge between AI coding assistants (Cursor, Claude Code, Windsurf, Codex) and the Unity Editor, enabling AI to manipulate GameObjects, manage scenes, run tests, and control assets directly inside the engine. It consists of a Unity package installed via the Package Manager and a Node.js server process that handles MCP protocol communication. Game developers use it to automate repetitive Unity tasks, generate scene content, run test suites, and debug projects through natural language instructions instead of manual editor clicks.
Prerequisites
- Unity 6 or later installed
- Node.js 18+ and npm 9+ installed on the development machine
- An MCP-compatible AI client: Cursor, Claude Desktop, Claude Code, or Windsurf
- Git (for installing the Unity package via Package Manager git URL)
Install the Unity package via Package Manager
Open Unity, go to Window > Package Manager, click the + button, select 'Add package from git URL...', and paste the repository URL to install the MCP Unity package.
https://github.com/CoderGamester/mcp-unity.gitConfigure the MCP server in Unity
After the package installs, navigate to Tools > MCP Unity > Server Window in the Unity menu. Use the 'Configure' button next to your AI client (Cursor, Claude Code, etc.) to automatically generate the correct MCP config, or note the path to the built server script for manual setup.
Add the server to your MCP client config manually (if needed)
If automatic configuration is not available for your client, add the server to your MCP JSON config using the absolute path to the built index.js file inside the installed package.
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"],
"env": {
"UNITY_PORT": "8090"
}
}
}
}Start Unity and verify the WebSocket connection
Open your Unity project. The MCP Unity package starts a WebSocket server on port 8090 by default. Confirm in the MCP Server Window that the status shows 'Connected' before using the AI client.
Interact with Unity through your AI assistant
With the connection established, you can ask your AI client to create GameObjects, assign components, run tests, load scenes, and perform other editor operations via natural language.
Unity Editor MCP Server Examples
Client configuration
Manual JSON config for Claude Desktop or Cursor pointing to the mcp-unity Node.js server. Replace the path with the actual absolute path on your system.
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": ["/Users/yourname/UnityProjects/MyGame/Library/PackageCache/com.coderGamester.mcp-unity/Server~/build/index.js"],
"env": {
"UNITY_PORT": "8090",
"LOGGING": "true"
}
}
}
}Prompts to try
These prompts demonstrate the server's ability to control Unity Editor objects, scenes, and tests through natural language.
- "Create an empty GameObject named 'Player' and add a Rigidbody component with mass set to 5"
- "Load the MainMenu scene and list all GameObjects in its hierarchy"
- "Run all EditMode tests in the project and show me the results"
- "Assign the BlueMaterial asset to the Enemy prefab's Renderer component"
- "Create a new scene called 'Level2' and save it to Assets/Scenes"Troubleshooting Unity Editor MCP Server
AI client cannot connect to Unity — WebSocket connection refused
Make sure the Unity Editor is open with the project loaded and the MCP Unity package is installed. The WebSocket server only runs while Unity is active. Check that UNITY_PORT (default 8090) is not blocked by a firewall or used by another process.
Path to index.js not found after package installation
Look for the built file inside Unity's Library/PackageCache directory under the com.coderGamester.mcp-unity folder. Alternatively, use the Tools > MCP Unity > Server Window automatic configuration which resolves the path for you.
Commands time out or produce no response
Increase UNITY_REQUEST_TIMEOUT in your env config (default is 10 seconds). For heavy operations like recompiling scripts or running large test suites, set it to 30 or 60 seconds.
Frequently Asked Questions about Unity Editor MCP Server
What is Unity Editor MCP Server?
Unity Editor MCP Server is a Model Context Protocol (MCP) server that model context protocol (mcp) plugin to connect with unity editor — designed for cursor, claude code, codex, windsurf and other ides It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Unity Editor MCP Server?
Follow the installation instructions on the Unity Editor MCP Server GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Unity Editor MCP Server?
Unity Editor MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Unity Editor MCP Server free to use?
Yes, Unity Editor MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Unity Editor MCP Server Alternatives — Similar Developer Tools Servers
Looking for alternatives to Unity Editor MCP Server? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Unity Editor MCP Server in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Unity Editor MCP Server?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.