Unity MCP 入门:连接 AI 与编辑器
完成 Unity MCP 的安装与配置,并让 AI 助手创建资产、修改场景、编辑脚本及触发编辑器任务。
- 1
准备 Unity 与 MCP 客户端
安装 Unity Hub 和兼容版本的 Unity Editor,同时准备支持 MCP 的 AI 客户端;确认项目已创建并能在 Unity 中正常打开。
- 2
克隆并安装 Unity MCP
打开 GitHub 的 CoplayDev/unity-mcp 仓库,按 README 使用 Unity Package Manager 导入本地包,或克隆后通过 Add package from disk 选择 package.json。
- 3
配置 MCP 服务
依据仓库文档,在 AI 客户端的 MCP 配置中添加 unity-mcp 服务及启动命令;将路径、Python 环境和项目参数替换为本机实际值。
- 4
连接并验证编辑器
启动 Unity 项目并运行 MCP 服务,在客户端查看连接状态;向 AI 发送“获取当前场景对象”等指令,确认 Unity 响应。
- 5
完成首个自动化任务
让 AI 在场景中创建 Cube、设置位置和材质,或生成一个 C# 脚本;检查 Hierarchy、Inspector 与 Console,并保存项目。
- 6
扩展项目工作流
尝试批量管理 Prefab、更新场景对象、运行编辑器菜单任务;重要改动前建立 Git 提交,便于审查和回退。
💡 实用技巧
- 先验证连接,再执行批量修改
- 使用绝对路径避免服务启动失败
- 为不同 Unity 项目配置独立客户端
- 让 AI 修改后检查 Console 报错
⚠️ 常见坑
- Python 依赖或环境变量未配置
- Unity 版本与插件要求不兼容
常见问题
Q:Unity MCP 本地包怎么安装?
打开 CoplayDev/unity-mcp 仓库,将项目克隆到本地。在 Unity 的 Package Manager 中选择从磁盘添加包,定位仓库内的 package.json 并完成导入,然后重新打开项目确认包已加载。
Q:MCP 服务启动后连不上 Unity 怎么办?
先检查 MCP 配置中的启动命令、Python 环境、unity-mcp 路径和 Unity 项目参数是否都指向本机实际位置。建议使用绝对路径,分别启动 Unity 项目与 MCP 服务,再在客户端查看连接状态并发送“获取当前场景对象”验证。
Q:AI 创建的 Cube 脚本没生效怎么排查?
先确认 AI 已成功连接 Unity,并让执行结果出现在 Hierarchy、Inspector 或 Console 中。若操作未执行,检查服务连接与项目路径;若脚本或材质有报错,在 Console 查看具体信息,修正后让 AI 重新执行并保存项目。