搞好了Unity安装,接下来进入正题了。
MCP工具下载地址:
先介绍以下这个MCP包的作用吧,直接来自于原项目引用
Unity MCP 软件包介绍
一个 Unity 包,可通过模型上下文协议 (MCP) 在 Unity 和 Claude Desktop 等大型语言模型 (LLM) 之间实现无缝通信。该服务器充当桥梁,允许 Unity 向符合 MCP 标准的工具发送命令和接收响应,使开发人员能够自动化工作流程、作资源并以编程方式控制 Unity 编辑器。
欢迎使用这个开源项目的初始版本!无论您是希望将 LLM 集成到 Unity 工作流程中,还是为令人兴奋的新工具做出贡献,我都感谢您花时间查看它!
概述
Unity MCP 服务器在 Unity(通过 C#)和 Python 服务器之间提供双向通信通道,从而实现:
- Asset Management:以编程方式创建、导入和作 Unity 资源。
- 场景控制:管理场景、对象及其属性。
- Material Editing(材质编辑):修改材质及其属性。
- 脚本集成:查看、创建和更新 Unity 脚本。
- Editor 自动化:控制 Unity Editor 功能,如撤消、重做、播放和构建。
该项目非常适合希望利用 LLM 来增强其 Unity 项目或自动执行重复性任务的开发人员。
以下安装过程基本是搬运,有些命令行运行问题我做了修改,算是实操版吧。
一、MCP包安装
要使用 Unity MCP 包,请确保已安装以下内容:
- Unity 2020.3 LTS 或更高版本 (⚠️目前仅适用于 URP 项目)(这个在上回的Unity安装,我们已经大概了解了吧)
- Python 3.12 或更高版本
- UV 包管理器
第 1 步:安装 Python
从 python.org 下载并安装 Python 3.12 或更高版本。确保在安装过程中将 Python 添加到系统的 PATH 中。
既然我说是从0开始,那就列出具体步骤:
在 Windows 中使用命令行安装 Python 的步骤如下:
-
确保你的系统安装了 PowerShell 或命令提示符(cmd)。
-
打开 PowerShell 或命令提示符,输入以下命令,直接从Python 官网 下载并安装 Python:
powershell
winget install Python.Python.3
-
安装完成后,验证 Python 是否安装成功:
powershell
python --version
如果 winget
命令不可用,可以手动下载 Python 安装包:
-
打开浏览器,访问Python 官网.
-
下载适合 Windows 的安装包。
-
双击安装程序,勾选 "Add Python to PATH",然后按照提示完成安装。
安装完成后,同样可以用 python --version
检查是否安装成功。
在Powershell中查看版本,返回以下状态就代表安装成功了
C:\Users\XXX> python --version
Python 3.13.2
第 2 步:安装 uv
uv 是一个 Python 包管理器,可简化依赖项管理。根据您的作系统使用以下命令安装它:
苹果电脑:
brew install uv
Windows (窗口):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
然后,将 uv 添加到 PATH 中:
set Path=%USERPROFILE%\.local\bin;%Path%
Linux的:
curl -LsSf https://astral.sh/uv/install.sh | sh
有关其他安装方法,请参阅 uv 安装指南。
重要说明:请勿在未安装 uv 的情况下继续作。
按照官方操作,你可能会遇到一下问题:
PS C:\Users\XXX> powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Error: PowerShell requires an execution policy in [Unrestricted, RemoteSigned, Bypass] to run uv. For example, to set the execution policy to 'RemoteSigned' please run:
Set-ExecutionPolicy RemoteSigned -scope CurrentUser
这是执行策略的问题,可以这么操作
PS C:\Users\XXX> powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Downloading uv 0.6.9 (x86_64-pc-windows-msvc)
Installing to C:\Users\XXX\.local\bin
uv.exe
uvx.exe
everything's installed!
To add C:\Users\XXX\.local\bin to your PATH, either restart your shell or run:
set Path=C:\Users\XXX\.local\bin;%Path% (cmd)
$env:Path = "C:\Users\XXX\.local\bin;$env:Path" (powershell)
这就代表安装好了,接下来配置环境变量(安装完已经给提示了,以下只展示PS的命令行)
重新打开一个Powershell页面(这很重要),运行:
$env:Path = "C:\Users\XXX\.local\bin;$env:Path"
第 3 步:安装MCP的 Unity 包
- 打开 Unity 并转到 。
Window > Package Manager
- 单击 按钮并选择 。
+
Add package from git URL
- 进入:
https://github.com/justinpbarnett/unity-mcp.git
看到这个状态,代表安装成功
安装后,Unity MCP 包将在您的 Unity 项目中可用。当与 MCP 客户端(如 Claude Desktop 或 Cursor)一起使用时,服务器将自动启动。
二、MCP与Cursor关联
1.打开MCP Editor
打开Unity编辑器,windows-->Unity MCP,打开MCP Editor
2.关联Cursor
确保你的Cursor也打开了,并且打开的文件夹就是你在Unity中建立的项目文件夹。
如果前面安装都正确,这时候MCP Editor中Connected灯应该是绿色
点击Auto Configure Cursor,然后得到如下图状态,表明MCP已经可以在Cursor中调用了。
这时会弹出两个命令行窗口,代表服务正在运行,不要关闭他们,最小化就好。
3.在Cursor中使用MCP调用Unity工作
接下来你就可以在Cursor中调用MCP工具了,如果你不放心,还可以问问Cursor:
@https://github.com/justinpbarnett/unity-mcp 我给Unity安装了这个MCP软件包,你现在可以调用其服务,控制unity编辑器了么?
如果得到肯定的回答,那就没跑儿了。
接下来就是要考验我们把话说清楚的能力,以及MCP工具自身能力了
大家只要遵循不会就让AI帮你出主意的思路,就能一步步开始了,
我随便写了点需求,让Cursor帮我做个规划,欢迎高手拍砖
现在就开始构建城市吧,按照你之前的规划来建设,先只构建城市基础道路系统。这个城市的道路总长不少于10km,包含规划中的各种道路类型,路网要闭合,形成环型道路。可以一步步来,如果有需要选择的,请暂停,让我来选择。所有材质使用Unity自带材质或者网上可找到的材质搭建。正式开始前,你还有什么需求不明确,可以问我。
实际使用过程中,发现目前开源的这个MCP功能还是有些局限和问题的,总之应用材质和纹理的脚本总是执行不了。当然,也不排除Cursor的脚本本身有问题,由于我是Unity使用小白,还无法定位问题。
这更证明了目前AI就是我们能力的放大器,如果你足够专业,那它还必须靠你来审核输出,但是可以帮你完成很多重复性工作,以及帮你分析解决方案。以下是我花1个小时用Cursor做的效果。对于专业人士,这也就是十几分钟的工作罢了。
我目前还在和Cursor拉扯提示词,确认MCP能力边界。虽然没有惊艳的效果,但是MCP确实给出了未来开发工作的更多提效可能性。有新的进展我再继续更新。