Unity AI代理开发工具

MCP for Unity是一个允许开发者在Unity中直接集成和开发AI代理的工具,适用于物流、工厂等3D场景的机器人部署和移动控制。

  • by NamWoo
  • 本地部署
  • 更新于
在 GitHub 查看 NamWoo/TrainingSupport-20251211-UnityMCP

使用说明

MCP for Unity

概述

指导您安装MCP,以便在Unity中直接粘贴和开发AI Agent。 利用Unity免费提供的工厂、物流仓库场景,使用MCP部署和移动机器人。

  • Unity仓库(HDRP)
    • https://assetstore.unity.com/packages/3d/environments/industrial/unity-warehouse-276394
  • 统一工厂(HDRP)
    • https://assetstore.unity.com/packages/3d/environments/industrial/unity-factory-276400

顺序是

  1. 安装GPT服务
  2. Unity安装
  3. 安装MCP for Unity

然后在Unity中开始开发。

AI Client安装

安装要用作客户端的GPT服务。

  1. 谷歌 Antigravity
  2. Cursor
  3. Claude Code
  4. OpenAI Codex

可以使用。以上服务均已确认运行良好,最终 Model、有/免费的差异会影响性能。大家都有免费服务,不妨先免费进行。

我 Cursor 也连接一下 Codex (OpenAI)也会连接的

  1. Cursor在Cursor桌面应用环境中。
  2. Codex将以Cli、Command Line的Terminal方式进行。

Cursor安装

只需下载并安装即可。

  1. https://cursor.com/download
  2. https://docs.cursor.com/ko/get-started/installation

Codex安装

Windows为WSL,Mac为基本终端

  1. 在窗口中https://developers.openai.com/codex/windows
    1. 配置和安装WSL环境后
    2. 控制+ R
    3. cmd命令后在终端上 WSL
    4. wsl
      1. curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
      2. 新建终端窗口 WSL 打开 nvm install 22
      3. 而且 codex
  2. 在Mac上https://developers.openai.com/codex/cli
    1. brew install codex
    2. 而且 codex

Unity安装

  1. Unity安装
    1. install Unity Hub
      1. https://docs.unity3d.com/hub/manual/InstallHub.html
    2. install Unity编辑器
      1. https://unity.com/releases/editor/archive
      2. 基于当前日期Unity 6000.3.1f1 可以下载到。
        1. 在这里 6000.0.64f1 我要下载版本。
          1. unityhub://6000.0.64f1/5360b7cd7953
          2. 第一个Major版本 6000 银 Unity6 意味着
          3. Minor版本的第二个 0 银 Unity6.0 意味着
          4. 6000.3.1f1如果是 Unity6.3 的意思。
      3. 6000.0.64f1 下载链接
        1. 如果安装了Unity Hub,
        2. 单击此处下载Editorunityhub://6000.0.64f1/5360b7cd7953
        3. Download Unity仓库项目
  2. 运行Unity
    1. 在Unity Hub上
      1. 在Unity Hub上,单击Projects窗口、New Project,查看现在下载的Editor版本
      2. 【重要】下面列出了Templates, High Definition 3D 选择项目
      3. 在右侧设置项目名称,保存位置后创建项目
    2. 在Unity Editor中
      1. 下载Unity Warehouse示例
        1. 如果编辑器正常打开,并且右上角的编译过程也全部完成,
        2. 下载Unity Sample Project并安装和连接MCP
        3. 进入顶部Window->Package Manager
          1. In Project, Unity Registry, My Assets …等等,可以在左边确认
          2. In Project可以查看当前项目中的Asset
          3. Unity Registry可以查看Unity直接提供的Asset
          4. My Assets可以查看拥有的Asset
        4. 为了在My Asset中注册Unity Asset Store免费发布的示例,并将我注册的Asset下载到当前项目中,
          1. [Web]利用Asset Store中公开的免费资源
            1. https://assetstore.unity.com/packages/3d/environments/industrial/unity-warehouse-276394
            2. 在Asset Store中,可以查看开发者、设计师和建模师正在创建和提供的Asset(有/免费)
            3. Add to My Assets 选择
          2. 在Unity Editor中 Package Manager - Unity Warehouse 验证是否存在(刷新底部)
            1. Download 选择,完成后 Import 1.0 to project
            2. 在新窗口中 import

下载和设置MCP for Unity

  1. 在Unity中
    1. 安装
      1. 再 Package Manager 选项卡顶部显示的 + 选择后 Add package from git URL...
      2. https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity 安装
      3. 安装完成后,请在顶部 Window在 MCP for Unity 可以查看项目
    2. 设置“重要”
      1. 设置
        1. 启用Show Debug Logs选项
      2. 连接
        1. Transport Stdio
        2. 而且 Start Session
        3. 绿灯 确认激活
      3. 客户端配置
        1. 设置要用于客户端的AI Agent Cursor
          1. 选择您要使用的GPT服务
        2. 使用Configure按钮 绿灯 确认

确认正常动作并开始

  1. 在Unity中
    1. Unity顶部 Window在选项卡中 MCP for Unity 打开项目
      1. 会话必须禁用绿卡
      2. 不需要客户端配置绿灯
  2. 在Cursor中
    1. 单击Cursor顶部齿轮形状, Cursor Setting
    2. 在左侧选项中, Tools & MCP
    3. 在下面的Installed MCP Servers中 unityMCP 项目必须可见,必须有绿灯
      1. (通过Unity->MCP for Unity->客户端配置连接)
  3. 创建Unity Project时 HDRP
    1. 由于当前使用的Unity Warehouse示例是基于HDRP创建的,因此将其用作HDRP。
  4. 现在开始
    1. 如果三个人都是绿灯的话,
    2. 如果Unity项目是浮动的,
    3. 可以直接从Cursor的Unity开发LLM提示命令开始。

LLM命令

我想在现在打开的场景中组建工厂warehouse。在项目窗口中搜索资源,如果其中有warehouse建筑的资源,就给它布置,里面填满几个wrack和Parlet,人等等内部。