Unity MCP 入门:安装并创建首个场景
完成插件安装、MCP 客户端连接与基础配置,并让 AI 创建对象、添加组件及保存一个可运行的 Unity 场景。
- 1
准备 Unity 与 MCP 客户端
安装 Unity Hub,并创建或打开一个 Unity 2022.3 及以上项目;同时准备支持 MCP 的 AI 客户端,如 Cursor。
- 2
安装 Unity MCP 插件
在 Unity 项目中打开 Window→Package Manager,进入 Add package from git URL,粘贴仓库地址并确认安装;随后重启 Unity 完成导入。
- 3
启动本地 MCP 服务
打开插件提供的 Unity 编辑器面板,按提示启动 MCP 服务,复制显示的本地地址、端口或连接参数,勿关闭对应 Unity 窗口。
- 4
配置 AI 客户端
在 Cursor 等客户端的 MCP 设置中新增服务器,填入 Unity 面板给出的连接信息,保存后测试连接,并确认客户端能识别 Unity 工具列表。
- 5
创建并检查首个场景
在 AI 对话框输入“创建一个包含相机、灯光和立方体的场景”,执行后切回 Unity,检查层级、场景视图及立方体组件是否正确。
- 6
保存并运行验证
让 AI 将场景保存为 Assets 下的场景文件,再点击 Unity 顶部 Play 按钮运行;确认对象正常显示,停止后手动保存场景。
💡 实用技巧
- 先测试连接,再执行批量编辑器操作
- 明确对象名称、位置和组件类型
- 每次改动后切回 Unity 检查结果
- 项目文件建议先提交 Git
⚠️ 常见坑
- Unity 关闭后本地服务会中断
- Git 包导入失败时检查网络与路径
常见问题
Q:Git 地址导入失败该怎么处理?
确认网络可访问 Git 仓库,并检查粘贴的仓库地址是否完整;Unity 版本需为 2022.3 及以上。若仍失败,可先排查代理、仓库权限及地址格式,再重新通过 Add package from git URL 安装。
Q:客户端连不上 Unity 怎么办?
确认 Unity 编辑器面板中的 MCP 服务已启动,并保持对应 Unity 窗口开启;随后核对 Cursor 中填写的本地地址、端口或连接参数,保存后重新测试连接,并检查客户端是否识别到 Unity 工具列表。
Q:AI 创建的场景保存在哪里?
在对话中明确要求 AI 将场景保存到 Assets 目录下,并指定场景文件名,例如 Assets/FirstScene.unity。保存后切回 Unity 检查层级、场景视图和组件,再点击 Play 验证运行效果。