AnkleBreaker-Studio/unity-mcp-server

解决的问题

AnkleBreaker Unity MCP 将 AI 助理连接至 Unity 游戏引擎，使其能够编写场景、管理游戏对象、运行测试以及处理构建。它解决了同时跨多个 Unity 项目与编辑器协调 AI 代理的困难，为代理提供了一种结构化的方式，无需人工干预即可与 Unity Editor 及运行中的游戏进行交互。

运作方式

该项目由一个 Node.js 服务器与一个 Unity 插件组成。服务器实现了 Model Context Protocol (MCP)，作为 AI 客户端（如基于 LLM 的助理）与 Unity Editor 之间的桥梁。它使用请求本地路由 (request-local routing) 来确保不同的代理可以锁定特定的 Unity 项目实例。Unity 插件负责在编辑器内执行实际指令，并管理队列以序列化写入操作与批量读取，从而维持稳定性。

适用对象

希望利用 AI 代理自动化场景构建、迭代多人游戏场景、执行性能分析，或跨多个编辑器实例管理项目级任务的 Unity 开发者与技术美术。

特色亮点

• 多项目协调：支持针对多个开启的 Unity 编辑器进行独立的请求路由与分离的队列管理。
• 丰富的工具集：提供超过 80 个公开的 MCP 工具，以及数百个用于场景编写、材质、性能分析与 Unity Hub 集成的进阶工具。
• 多人游戏支持：包含针对 Multiplayer Play Mode (MPPM) 与 ParrelSync 的特定工具，用于协调主机/客户端场景。
• 可观测性：具备 Unity 仪表板以监控代理工作阶段、请求队列与动作历史，并支持命名撤销 (named undo)。
• 性能优化：实现了有界编译器元数据重用与分页测试结果，以降低代码执行与数据检索的延迟。