Unity MCP：AI助理与Unity编辑器的桥梁

这是什么

unity-mcp 是一个开源 Unity 编辑器扩展，由 CoplayDev 团队维护（主语言 C#，GitHub 星标 11363），当前版本 v10.0.0。它通过 Model Context Protocol（MCP）将 AI 助手（Claude、Codex、VS Code、本地 LLM、Gemini CLI 等）与 Unity Editor 桥接起来，让开发者可以用自然语言直接操控编辑器。项目基于 MIT 许可证免费使用，同时 Aura 公司也提供付费的 Unity/Unreal AI 助手 Aura for Unity。

解决的问题

传统 Unity 开发中，场景创建、资源管理、脚本编写、测试运行等操作都需要手动完成，或通过编写 C# 脚本、查找菜单项来实现。人工智能助手（如大语言模型）虽能生成代码，但无法直接与 Unity 编辑器交互——它们无法在场景中放置物体、修改材质、运行测试或切换 Play Mode。unity-mcp 通过 MCP 协议为 AI 助手提供了 47 个聚焦的工具入口点，让 LLM 能够像人类开发者一样“操作”编辑器：创建 GameObject、调整 Transform、执行 Asset 导入、运行 Editor 测试、读取 Console 日志等。这消除了 AI 生成代码与编辑器实际状态之间的鸿沟，使 AI 能真正参与游戏开发工作流。

核心功能

• 编辑器控制：通过 MCP 客户端用自然语言指令创建场景、GameObject、编辑 C# 脚本、管理资源、运行测试、Profile、构建项目。例如输入“在原点创建一个立方体并添加 Rigidbody”，数秒内即可在编辑器中完成。
• 47 个 MCP 工具入口点：涵盖场景操作、资源导入导出、脚本编辑、测试运行、版本控制辅助、构建配置等，每个工具聚焦单一任务，便于 AI 调度。
• 多实例路由（Multi-Instance Routing）：支持同时操作多个 Unity 实例，每个实例独立绑定到不同 MCP 客户端，适合多开编辑器进行对比测试或并行开发。
• 工具组（Tool Groups）：按功能领域分组（VFX、动画、UI、测试等），可针对不同任务启用/禁用特定工具组，减少 AI 不必要的工具选择。
• Roslyn 脚本验证（Roslyn Validation）：AI 生成的 C# 脚本在写入文件前会通过 Roslyn 编译器进行静态检查，避免语法错误直接进入编辑器。
• 远程托管服务器（Remote Server with Auth）：可将 MCP Server 部署到远程机器，通过认证机制安全地连接本地编辑器，适合团队协作或云端 CI 环境。
• 学术引用支持：项目已被 ACM SIGGRAPH Asia Technical Communications 2025 收录（论文 ID: 10.1145/3757376.3771417），提供 BibTeX 便于引用。

亮点 / 与同类相比

• MCP 原生集成：统一使用 Model Context Protocol 标准，与 Claude Desktop、VS Code、Cursor、Windsurf、Cline、Gemini CLI 等主流 MCP 客户端直接兼容，无需额外适配。相比之下，许多 Unity AI 插件仅绑定特定 AI 平台（如仅支持 OpenAI API 或仅支持内置聊天）。
• 开源且免费：MIT 许可证，可自由修改和商用，无隐藏费用。同类工具如 Aura for Unity 是付费产品，而 unity-mcp 提供了核心能力的免费替代。
• 低上手门槛：仅需 Unity 2021.3 LTS 及以上版本和 Python 3.10+，通过 Unity Package Manager 添加 Git URL 即可安装。配置时通过 Window → MCP for Unity → Configure All Detected Clients 一键自动检测并配置所有已安装的 MCP 客户端。
• 深度编辑器能力：47 个工具不仅覆盖基础操作，还包含 Profile、Build、测试运行等高级功能，甚至支持多实例路由，这常见于专业 CI/CD 工具，而非简单的 AI 插件。
• 学术背书：有 ACM 论文支撑，提供了协议驱动框架的详细设计思路，适合研究者和希望理解 MCP 与游戏引擎结合的技术团队。

适合谁用 / 上手

• 独立游戏开发者：快速用自然语言原型场景原型，无需频繁切换编辑器与文档。
• AI/Game 交叉领域研究者：利用 MCP 协议做交互式 3D 内容生成实验，或构建基于 LLM 的关卡设计工具。
• 游戏工作室技术美术/程序员：集成到 CI 流程中，自动执行资源检查、场景验证或批量测试。
• 需要低代码方案的教学团队：让学生通过 AI 对话学习 Unity 操作，同时验证 AI 生成的脚本正确性。
• 主要要求：Unity 2021.3 LTS ~ 6.x，Python 3.10+（通过 uv 安装），任意 MCP 客户端（Claude Desktop、VS Code、Cursor 等）。安装步骤：Unity → Package Manager → Add package from git URL → 输入 https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main（可指定版本如 v10.0.0）。或使用 OpenUPM 命令 openupm add com.coplaydev.unity-mcp。配置后即可在客户端中输入自然语言指令开始使用。