Unity Code MCP Server
MCP server that connects AI agents to the Unity Editor. Enables AI-driven scripting, scene manipulation, asset management, and configuration changes through natural language.
MCP ServerSkillPlugin
Free✦
16 GitHub stars
✦
Open source under MIT license — free to use and modify
✦
MCP server connecting AI agents to Unity Editor API
What is Unity Code MCP Server? Features and use cases explained.
About Unity Code MCP Server
UnityCodeMCPServer gives AI agents the ability to perform any action using Unity Editor API. It provides a set of MCP tools that let AI inspect live scenes, components, assets, console output, settings, Play Mode state, and runtime values. The AI can execute generated C# scripts directly in the Editor to create and modify GameObjects, prefabs, ScriptableObjects, import settings, and more. It also supports running EditMode and PlayMode tests, capturing screenshots, simulating player input, and reading console logs. Designed for game developers who want to automate Unity workflows with AI, it works with any MCP-compatible client and includes a STDIO bridge for secure communication.
Use Cases
- ▸Automate level prototyping by generating GameObjects and modifying scene hierarchy through natural language instructions
- ▸Debug runtime issues by entering Play Mode, simulating specific inputs, and inspecting console logs and game state
- ▸Verify asset import settings by executing C# code that modifies ScriptableObjects and checks results via console output
- ▸Perform regression testing by running a suite of PlayMode tests and capturing screenshots for visual comparison
- ▸Speed up prefab creation by using AI to generate and configure prefabs with proper components and settings
Features
- ✓Executes C# scripts in Unity Editor with full access to UnityEngine, UnityEditor, and reflection
- ✓Reads Unity Editor console logs with configurable entry limits from 1 to 1000
- ✓Runs Unity tests via TestRunnerApi in EditMode, PlayMode, or both with optional test name filters
- ✓Enters Play Mode, pauses time, and returns immediately for setup before gameplay automation
- ✓Simulates Input System actions while temporarily unpausing time and collecting logs
- ✓Captures the current Unity Game View screenshot without routing through gameplay input
- ✓Exits Play Mode and unpauses time, returning immediately after transition
- ✓Returns detailed information about the Unity Editor project and server settings
FAQ
Does this work with any Unity version?▼
UnityCodeMCPServer is designed to work with Unity 2020.3 and newer, including Unity 6. It integrates as a plugin in your project without modifying core files.
How do I connect an AI client to Unity?▼
After installing the package via UPM or Git, configure your AI client (e.g., Claude, Cursor) to use the STDIO bridge or custom transport. The server starts automatically when Unity opens if enabled in settings.
Is it safe to let AI execute code in my project?▼
We recommend reviewing all generated scripts before execution, especially those using reflection. Use a separate Unity project or run Unity in an isolated environment (VM/container) for sensitive work.
Can I add custom MCP tools?▼
Yes, you can extend the server by adding your own tools using the provided API. See the Extending section in the README for detailed instructions.
Does it work with multiplayer or networking setups?▼
The server operates on the Editor process and can interact with networked scenes, but you must ensure your network code is deterministic when using play_unity_game with input simulation.
How to install Unity Code MCP Server — setup guide and prerequisites.
Installation
Install Unity Code MCP Server to get started:
$git clone https://github.com/Signal-Loop/UnityCodeMCPServer.git
Or visit the project page for detailed setup instructions.
Similar Tools
Jabali AI
AI game generator for creating puzzle, shooter, anime games and more without coding. Instantly playable in minutes.
Plugin
Rosebud AI
Create playable games using AI prompts. Describe your idea or pick a template, then build and deploy without code.
Prompt
GPTGame
Generate simple 2D games from natural language descriptions. Instant playable prototypes with AI-generated code and assets.
LibreGameDev Claude Code Plugins
Claude Code plugins for Godot, Unity, and Unreal. Streamline game development with AI-assisted coding, asset generation, and engine-specific tasks.
SkillPlugin
UnrealClaude
Integrates Claude Code CLI with Unreal Engine 5.7. Provides AI coding assistance with built-in UE5.7 documentation context directly in the editor.
MCP ServerPlugin
Unity MCP
Bridges AI assistants with Unity Editor. Enables asset management, scene control, script editing, and task automation through natural language.
MCP ServerPrompt