MCP for Unity

MCPOfficialOpen SourceMIT96.4

by CoplayDev • Uncategorized

An MCP server that integrates large language models with the Unity Editor to enable AI-driven development and automation.

Example Use Cases

1
Control and automate Unity Editor tasks using natural language.
2
Manage Unity assets, scenes, scripts, and editor functions programmatically.
3
Integrate AI assistants with Unity for enhanced development workflows.

Description

MCP for Unity bridges AI assistants like Claude, Cursor, and VS Code Copilot with the Unity Editor via the Model Context Protocol. It allows natural language control to manage assets, scenes, scripts, and automate Unity workflows, enhancing productivity and enabling powerful AI-assisted Unity app creation. The server supports multiple Unity instances and offers extensive tools and resources for comprehensive Unity project management.

Capabilities(60 total)

Tools (42)

batch_execute

Executes multiple MCP commands in a single batch for dramatically better performance. STRONGLY RECOMMENDED when creating/modifying multiple objects, adding components to multiple targets, or performing any repetitive operations. Reduces latency and token costs by 10-100x compared to sequential tool calls. The max commands per batch is configurable in the Unity MCP Tools window (default 25, hard max 100). Example: creating 5 cubes → use 1 batch_execute with 5 create commands instead of 5 separate calls.

commands:array*parallel:anyfail_fast:anymax_parallelism:any

debug_request_context

Return the current FastMCP request context details (client_id, session_id, and meta dump).

execute_code

Execute arbitrary C# code inside the Unity Editor. The code runs as a method body with access to UnityEngine and UnityEditor namespaces. Use 'return' to send data back. Compiled in-memory — no script files created. Actions: execute (run code), get_history (list past executions), replay (re-run a history entry), clear_history. NOTE: safety_checks blocks known dangerous patterns but is not a full sandbox. Compiler options: 'auto' (Roslyn if available, else CodeDom), 'roslyn' (C# 12+, requires Microsoft.CodeAnalysis), 'codedom' (C# 6 only).

action:string*code:anysafety_checks:booleanindex:anylimit:integercompiler:string

execute_menu_item

Execute a Unity menu item by path.

menu_path:any

find_gameobjects

Search for GameObjects in the scene by name, tag, layer, component type, or path. Returns instance IDs only (paginated). Then use mcpforunity://scene/gameobject/{id} resource for full data, or mcpforunity://scene/gameobject/{id}/components for component details. For CRUD operations (create/modify/delete), use manage_gameobject instead.

search_term:string*search_method:stringinclude_inactive:anypage_size:anycursor:any

Resources (18)

editor_state

Canonical editor readiness snapshot. Includes advice and server-computed staleness. URI: mcpforunity://editor/state

URI: mcpforunity://editor/stateMIME: text/plain

editor_active_tool

Currently active editor tool (Move, Rotate, Scale, etc.) and transform handle settings. URI: mcpforunity://editor/active-tool

URI: mcpforunity://editor/active-toolMIME: text/plain

cameras

List all cameras in the scene (Unity Camera + CinemachineCamera) with status. Includes Brain state, Cinemachine camera priorities, pipeline components, follow/lookAt targets, and Unity Camera info. URI: mcpforunity://scene/cameras

URI: mcpforunity://scene/camerasMIME: text/plain

gameobject_api

Documentation for GameObject resources. Use find_gameobjects tool to get instance IDs, then access resources below. URI: mcpforunity://scene/gameobject-api

URI: mcpforunity://scene/gameobject-apiMIME: text/plain

project_layers

All layers defined in the project's TagManager with their indices (0-31). Read this before using add_layer or remove_layer tools. URI: mcpforunity://project/layers

URI: mcpforunity://project/layersMIME: text/plain

Quick Actions

View on GitHub

Security

Scanned 1 month(s) ago

Risk Level

CRITICAL

Shell/code execution or full filesystem access

Trust Score

C50/100

6/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities42 Tools / 0 Prompts / 18 Resources

OwnerCoplayDev

CategoryUncategorized

DependenciesUnity Editorrequired

Set Your Username