AnkleBreaker-Studio/unity-mcp-server

解决的问题

该项目为 AI 助手（如 Claude、Cursor 和 Windsurf）与 Unity 游戏引擎之间提供了一个全面的桥梁。开发者可以直接通过 AI 聊天界面控制 Unity 编辑器和 Unity Hub，无需手动执行重复的编辑器任务、场景设置和项目管理。

工作原理

它实现了 Model Context Protocol (MCP)，作为服务器将 AI 命令转换为 Unity 内部的操作。架构由三部分组成：AI 助手、MCP 服务器（本仓库）以及一个运行 HTTP API 桥接的配套 Unity 编辑器插件。服务器通过 Unity Hub CLI 进行安装任务，通过 Unity 插件进行实时编辑器操作。

适用人群

希望自动化工作流、快速原型化场景，或使用 AI 作为共同开发伙伴来完成从简单对象放置到复杂着色器和地形编辑等游戏开发任务的 Unity 游戏开发者。

主要亮点

• 庞大的工具集：涵盖 30 多个类别，超过 330 个工具，包括场景管理、物理、光照、动画和性能分析。
• 深度集成：支持 Shader Graph、Amplify Shader Editor、NavMesh 烘焙和 Memory Profiler 等高级 Unity 功能。
• 智能工具管理：采用两级系统（核心工具和高级工具），防止 AI 助手的上下文窗口被过度填充。
• 稳健的连接性：具备多实例发现、端口容错和崩溃检测功能，确保编辑器重启或编译期间连接稳定。
• 视觉反馈：可捕获场景和游戏视图的截图，供 AI 视觉检查其操作结果。