Unity-Open-MCP

[](https://alexeyperov.github.io/unity-open-mcp/) [](https://unity.com/releases/editor/archive) [](https://modelcontextprotocol.io/introduction) [](https://opensource.org/licenses/MIT) <p align="center"> <img src="hub/src-tauri/icons/Square310x310Logo.png" alt="MCP for Unity" width="250"> </p> # Unity Open MCP Unity Open MCP 通过桥接 + 网关工作流将 AI 代理连接到 Unity 项目：进行更改、运行验证、检查结果并安全地迭代。 MCP 服务器总共包含 **229** 个工具。 当前工具表面来自 `mcp-server/src/tools/index.ts`: - 核心 + 网关 + 验证工具：**16** - 资产智能 + 感知 + 发现 + 诊断 + 元工具：**34** - 类型编辑器/项目工具（核心包）：**92** - 可选扩展包工具：**87** ## 关键功能 - 具有 **自动验证、检查点、差异、回归检查和目标修复** 的安全突变工作流。 - 资产智能工具，包括 **重新序列化、结构化资产读取/搜索和引用分析**。 - 即时 + 回退路由（即时 Unity 桥接、支持的工具的批处理模式、尽可能的离线读取器）。 - 用于场景、GameObjects、组件、包、构建设置、性能分析器控制和项目设置的 Typed Unity 工具表面。 - 捆绑的领域工具组，包括 **导航、输入系统、ProBuilder、粒子系统、动画、样条曲线、照明、音频、UI、约束和 LOD、地形、Cinemachine、时间线、Tilemap、着色器图、VFX 图和内存分析器** — 嵌入在桥接中，当匹配的 Unity 包存在时自动编译（或无条件地用于诸如照明、音频、UI、约束和 LOD 和地形等内置模块；Cinemachine 是反射门控的 - 其程序集始终编译并在调用时检测支持的版本），并通过工具组在每个会话中显示。着色器图、VFX 图和内存分析器 **自动激活** - 它们的工具组在安装匹配的包时自动出现，无需手动选择。 - 用于引导设置的 Unity Hub Pro 向导和维护工作流。 有关完整的目录和合同，请参见 [docs/api/mcp-tools.md](docs/api/mcp-tools.md)。 需要 **Unity 2022.3 LTS 或更新版本**。 ## 快速设置 使用以下任意选项： 1. 安装 Unity Hub Pro 并使用其 **AI 设置向导**（最简单，无需控制台）：请参见 [向导设置](docs/wizard-setup.md)。  2. 如果您更喜欢手动设置：请参见 [手动设置](docs/manual-setup.md)。 3. 如果您更喜欢克隆此存储库并直接使用它：请参见 [开发设置](docs/development-setup.md)。适合贡献者工作流。 可选：为特定领域的 工作流安装扩展包：[扩展](docs/extensions.md)。 ## 文档 - [架构](docs/architecture.md) — 存储库边界和运行时流程。 - [技能](docs/skills.md) — 代理游戏手册（`SKILL.md`）运送到项目中。 - [API 索引](docs/api.md) — 合同文档映射。 - [桥接 HTTP API](docs/api/bridge-http.md) — 桥接端点和信封。 - [MCP 资源 API](docs/api/resources.md) — 资源 URI 和有效负载。 - [代码约定](docs/code-conventions.md) — 非显式 C# 决策（实例 ID、命名空间别名）。 - [版本控制](docs/versioning.md) — 共享服务器/桥接/验证版本和 Hub 应用程序版本如何管理、提升和保持同步；运行时兼容性检查。 > 想查看其他 MCP 选项？请参见 [Unity Open MCP 和其他 MCP 工具/AI 助手的功能比较矩阵](docs/mcp-tools-comparison.md)。 ## Unity Hub Pro Unity Hub Pro 是 Unity Open MCP 的桌面伴侣应用程序。它帮助您管理项目、运行 AI 设置向导并从一个 UI 处理维护工作流。 [查看文档以获取详细信息。](docs/unity-hub-pro.md) ## 贡献 - 随意为错误、功能请求和文档改进打开问题。 - 欢迎 PR。先从上面的文档开始，然后是用于本地开发详细信息的包级 README。 贡献者或希望在其自己的分支上工作的用户 的有用资源： - [验证套件](validation-suite/README.md) — 用于指导的手动验证的应用程序；提供可运行的场景包。 **许可证：** MIT — 请参见 [LICENSE](LICENSE)。