unity-mcp-orchestrator

unity-mcp-orchestrator 技能利用模型上下文协议 (MCP) 为大语言模型 (LLM) AI 助手与 Unity 编辑器之间提供完整的桥接。它专为希望将 AI 代理整合至游戏开发流程的 Unity 开发者与工程师设计，能够在 Claude、Cursor 或 VS Code 等 AI 环境中无缝控制编辑器操作。此技能通过将自然语言意图转化为结构化的 Unity Editor API 调用，简化了场景构成、快速原型制作与工作流程自动化等复杂任务。

• 与 MCP 完全整合，建立 AI 助手与 Unity Editor API 之间的沟通桥梁。

• 进阶游戏对象 (GameObject) 管理：支持创建、修改与层级调整。

• 全面脚本支持：创建、修改、应用并验证 C# 脚本，具备自动编译追踪功能。

• 强大的场景管理：执行多场景编辑、加载/卸载场景以及利用场景模板。

• 视觉验证工具：从多个角度拍摄截图、截取场景视图视角或进行以对象为中心的视觉审计。

• 批次处理能力：利用 batch_execute 功能平行处理多达 100 个操作，显著提升效能。

• 诊断与调试支持：即时监控控制台日志、编译错误检测以及通过 manage_profiler 进行性能分析。

• 广泛支持 Unity 子系统，包括物理 (2D/3D)、图形 (URP/后处理) 与 Cinemachine 摄像机。

• 务必遵循「资源优先」工作流程：在触发修改工具前，先查阅编辑器状态与场景资源。

• 修改脚本后，请在执行后续操作前，等待 AssetDatabase 自动完成编译。

• 使用 manage_camera 工具并设置 include_image=True，为 AI 代理提供场景调整所需的视觉上下文。

• 针对高频率或重复性任务优先使用 batch_execute，以减少延迟并提升 AI 代理互动效率。

• 请注意，模板与产生的脚本可能需要针对项目特定的套件版本（如 UGUI、TMP、Input System）进行验证。

• 密切监控 editor_state，以便有效地处理如域重载 (domain reloads) 或编译循环等阻塞操作。