Union Unity MCP
Enables AI agents to interact with Unity projects through multimodal vision, code analysis, asset management, and scene manipulation. Supports real-time Unity editor control, project search, script creation, and visual debugging through screenshots.
What is Union Unity MCP?
Union Unity MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai agents to interact with unity projects through multimodal vision, code analysis, asset management, and scene manipulation. supports real-time unity editor control, project search, script cr...
Enables AI agents to interact with Unity projects through multimodal vision, code analysis, asset management, and scene manipulation. Supports real-time Unity editor control, project search, script creation, and visual debugging through screenshots.
This server falls under the Developer Tools and Coding Agents categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI agents to interact with Unity projects through mu
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx union-unity-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Union Unity MCP
Union is a C# MCP server that embeds inside the Unity Editor and exposes AI agents to the full Unity project environment through a rich set of tools covering assets, scenes, scripting, search, and multimodal vision. Agents can open and edit scenes, create and compile C# scripts, import assets, run the project in play mode, take screenshots of the scene view, and search the entire project hierarchy all through natural language. Unity developers use it to accelerate game and application development by delegating repetitive editor tasks to an AI assistant without leaving their coding tool.
Prerequisites
- Unity 6000.0.x or higher (earlier versions may work but are untested)
- Node.js installed (required to run the npx runner)
- An MCP-compatible AI agent: Cursor, Claude Desktop, Claude Code, or Rider AI
- Windows or macOS operating system
- On macOS with Claude Code: grant Screen & System Audio Recording permissions in System Preferences
Create the mcp.json configuration file
Create an mcp.json file at the root of your project or in your agent's config directory. The runner will automatically install the Unity package into your project.
Configure the npx runner with your paths
Set the -unityPath argument to your Unity Editor executable and -projectPath to your Unity project root.
{
"mcpServers": {
"unity": {
"command": "npx",
"args": [
"-y",
"@nurture-tech/unity-mcp-runner",
"-unityPath", "<path to Unity Editor>",
"-projectPath", "<path to Unity project>"
]
}
}
}Launch Unity through your AI agent
Always launch Unity via your MCP client, not from the Unity Hub. Launching from the Hub prevents the MCP server from establishing its connection.
Verify the Unity package was installed
Check that the is.nurture.mcp package appears in your Unity project's Package Manager. You can safely commit this package to source control.
Test with a basic scene query
Ask your agent to get the editor state or take a screenshot to confirm the connection is working.
Union Unity MCP Examples
Client configuration
mcp.json configuration for Union with explicit Unity Editor and project paths.
{
"mcpServers": {
"unity": {
"command": "npx",
"args": [
"-y",
"@nurture-tech/unity-mcp-runner",
"-unityPath", "/Applications/Unity/Hub/Editor/6000.0.30f1/Unity.app/Contents/MacOS/Unity",
"-projectPath", "/Users/username/UnityProjects/MyGame"
]
}
}
}Prompts to try
Example prompts for controlling the Unity Editor through the MCP server.
- "Take a screenshot of the current scene view."
- "Create a new C# script called 'PlayerController' at Assets/Scripts/ that moves the player with WASD input."
- "Open the scene MainMenu and list all GameObjects in the hierarchy."
- "Search the project for all prefabs that contain a Rigidbody component."
- "Run the current scene in play mode for 5 seconds and take a screenshot of the result."Troubleshooting Union Unity MCP
Unity hangs on startup when using Cursor on Windows
This is a known issue caused by the Google External Dependency Manager (EDMU). Disable or remove the package from your project to work around it while the issue is investigated.
The search tool fails with 'Search index is not ready yet'
Wait for Unity to finish building its search index after opening the project, then retry. The index build time depends on project size.
MCP server cannot connect when Unity is launched from the Hub
Always launch Unity through your AI agent's MCP integration (e.g., by asking the agent to start Unity). The MCP server relies on being launched as a subprocess of the runner.
Frequently Asked Questions about Union Unity MCP
What is Union Unity MCP?
Union Unity MCP is a Model Context Protocol (MCP) server that enables ai agents to interact with unity projects through multimodal vision, code analysis, asset management, and scene manipulation. supports real-time unity editor control, project search, script creation, and visual debugging through screenshots. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Union Unity MCP?
Follow the installation instructions on the Union Unity MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Union Unity MCP?
Union Unity MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Union Unity MCP free to use?
Yes, Union Unity MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Union Unity MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to Union Unity MCP? 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 Union Unity MCP 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 Union Unity MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.