unity-mcp-orchestrator

The unity-mcp-orchestrator skill provides a comprehensive bridge between LLM-based AI assistants and the Unity Editor using the Model Context Protocol (MCP). It is designed for Unity developers and engineers looking to integrate AI agents into their game development pipeline, enabling seamless control over editor operations from within an AI-capable environment like Claude, Cursor, or VS Code. This skill streamlines complex tasks such as scene composition, rapid prototyping, and workflow automation by translating natural language intent into structured Unity Editor API calls.

• Full integration with MCP to bridge AI assistants with the Unity Editor API.

• Advanced GameObject management including creation, modification, and hierarchy manipulation.

• Comprehensive scripting support: create, modify, apply, and validate C# scripts with automatic compilation tracking.

• Robust scene management: perform multi-scene editing, load/unload scenes, and utilize scene templates.

• Visual verification tools: take screenshots from multiple angles, capture Scene View perspectives, or perform object-focused visual audits.

• Batch processing capabilities: utilize batch_execute to run up to 100 operations in parallel for improved performance.

• Diagnostic and debugging support: real-time console log monitoring, compilation error detection, and profiling via manage_profiler.

• Extensive support for Unity subsystems including Physics (2D/3D), Graphics (URP/Post-processing), and Cinemachine cameras.

• Always follow the resource-first workflow: consult editor state and scene resources before triggering modification tools.

• After script modifications, allow for automated compilation via AssetDatabase before attempting further operations.

• Use the manage_camera tool with include_image=True to provide the AI agent with visual context for scene-level adjustments.

• Prioritize batch_execute for high-frequency or repetitive tasks to minimize latency and improve the efficiency of your AI agent interactions.

• Be aware that templates and generated scripts may require validation against project-specific package versions (UGUI, TMP, Input System).

• Monitor editor_state closely to handle blocking operations like domain reloads or compilation cycles effectively.