AI 代码与自动化AI 撰写更新于 2026-10-25

Unity MCP 入门:连接 AI 与编辑器

完成 Unity MCP 的安装与配置,并让 AI 助手创建资产、修改场景、编辑脚本及触发编辑器任务。

关联工具UNUnity MCP官网 ↗
入门⏱ 约 20 分钟🎯 让 AI 通过 MCP 成功操控 Unity 编辑器
  1. 1

    准备 Unity 与 MCP 客户端

    安装 Unity Hub 和兼容版本的 Unity Editor,同时准备支持 MCP 的 AI 客户端;确认项目已创建并能在 Unity 中正常打开。

  2. 2

    克隆并安装 Unity MCP

    打开 GitHub 的 CoplayDev/unity-mcp 仓库,按 README 使用 Unity Package Manager 导入本地包,或克隆后通过 Add package from disk 选择 package.json。

  3. 3

    配置 MCP 服务

    依据仓库文档,在 AI 客户端的 MCP 配置中添加 unity-mcp 服务及启动命令;将路径、Python 环境和项目参数替换为本机实际值。

  4. 4

    连接并验证编辑器

    启动 Unity 项目并运行 MCP 服务,在客户端查看连接状态;向 AI 发送“获取当前场景对象”等指令,确认 Unity 响应。

  5. 5

    完成首个自动化任务

    让 AI 在场景中创建 Cube、设置位置和材质,或生成一个 C# 脚本;检查 Hierarchy、Inspector 与 Console,并保存项目。

  6. 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 重新执行并保存项目。

相关工具