Unity-MCP 使用指南:让 AI 连接并控制 Unity 编辑器
Unity-MCP(Model Context Protocol)的使用指南,旨在通过自然语言驱动 Unity 编辑器。内容涵盖 MCP 原理、安装前提条件(Git, Python, uv)、Unity 端插件安装与配置、以及 Trae IDE 端的 MCP 客户端设置。通过配置,开发者可以让 AI 智能体直接操作 Unity 场景,实现创建对象、添加脚本等功能,降低开发门槛,提升人机协作效率。

Unity-MCP(Model Context Protocol)的使用指南,旨在通过自然语言驱动 Unity 编辑器。内容涵盖 MCP 原理、安装前提条件(Git, Python, uv)、Unity 端插件安装与配置、以及 Trae IDE 端的 MCP 客户端设置。通过配置,开发者可以让 AI 智能体直接操作 Unity 场景,实现创建对象、添加脚本等功能,降低开发门槛,提升人机协作效率。

MCP(Model Context Protocol 模型上下文协议)可以想象成一个 AI 助手的'通用 USB-C 接口'。以前,每个 AI 应用要连接不同的数据源或工具,都需要专门的接口。
而 MCP 的目标是提供一个标准化的协议,让 AI 助手(比如 Claude、Cursor)能够通过这个'通用接口',方便、安全地连接并操控各种软件,其中就包括 Unity 编辑器。
一个典型的 Unity MCP 实现包含两部分:
可以把 Unity-MCP 想象成一个通用的翻译器和信使。它将 Unity 编辑器的复杂内部状态和功能,封装成一系列 AI 可以理解和调用的'工具'。从此,AI 不再只是'看'到你粘贴的代码片段,而是能真正'走进'你的项目,'看见'场景中的所有对象,'动手'修改属性甚至执行测试。
未连接 MCP 时,AI 也可以直接在 Unity 中操作,但是连接 MCP 之后更安全和便捷。
MCP 让 AI 从一个被动的'顾问'转变为一个主动的'协作者'的关键技术,Unity-MCP 将这种变革性的能力带入了游戏开发领域。

| 指令 | 效果 |
|---|---|
![]() | ![]() |
目前市面上有多款 Unity-MCP 工具,其基本作用都是给 AI 提供桥梁以使其可以直接在 Unity 中进行操作。
本文使用的是CoplayDev提供的unity-mcp,算是目前使用人数较多的 MCP,截至目前有 7k star 左右,还在持续更新中。
| 工具 | 地址 | 介绍 |
|---|---|---|
| unity-mcp(本文使用) | https://github.com/CoplayDev/unity-mcp | star:7k,持续更新中 |
| Unity-MCP | https://github.com/IvanMurzak/Unity-MCP | star:1.2k |
| mcp-unity | https://github.com/CoderGamester/mcp-unity | star:1.4k |
GitHub 下载地址:https://github.com/CoplayDev/unity-mcp
在使用 MCP 之前需要一些前提条件,否则没办法正常使用。
Git 和 Unity 正常我们肯定都安装了,额外需要安装一下 Python 和 uv 即可。
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main点击 Add(添加)。此过程会自动将 MCP Server 安装到计算机上。

安装提示 若通过 URL 添加不上,可以先在 github 将项目下载,然后通过 Add package from git disk… 选中本地 mcp 文件夹中的 package.json 进行添加。
安装完之后可以通过 Window → MCP For Unity 打开相关面板。

如果前提条件都安装好了,打开Local Setup Window会如下所示:

打开 Toggle MCP Window ,配置 MCP 客户端,可根据自己情况进行选择。
这里使用 Trae 做示例,URL 配置 http://localhost:8080 ,Client 选择自己的 IDE,这里选择Trae进行展示。
如下所示:

然后在 MCP For Unity 中点击Start Server开启,会弹出一个确认弹窗。

选择 Start Server 会开启一个终端弹窗,不要关掉该弹窗,关掉之后服务器会停掉,需要重新在 Unity 中点击 Start Server 开启。

这样 Unity 端的准备就都完成了,下面是去 Trae(或其他 IDE) 中进行配置。

点击右上角的 设置 -> MCP 选择手动添加。

添加以下 MCP 配置
{"mcpServers":{"unityMCP":{"url":"http://localhost:8080/mcp"}}}

打开该 unityMCP 即可看到其提供的功能支持。

打开 设置->智能体

可以选择创建一个智能体,也可以使用内置的 Build with MCP (默认使用配置的所有 MCP)

创建新的智能体时,要勾选前面添加的unityMCP。

此时在聊天框中选中刚创建的智能体就可以与其对话了。

如果默认选择的 AI 模型对话比较慢可以自行选择一个,Trae 内置了很多免费模型可使用。如果已经买过其他模型,也可以直接进行添加模型使用。

比如输入这样一段话:给我在场景中创建一个平面,然后添加一个角色,支持按 WASD 进行移动,移动速度为 5,支持按空格键进行跳跃。

等待 AI 执行完毕,回到 Unity 运行游戏查看效果。

这样我们一行代码都没有写,也没有手动操作 Unity,就完成了一个初级小功能。
Unity-MCP 不仅仅是一个技术工具,它代表了一种人机协作的新范式。通过为 AI 提供标准化的'上下文'和'行动能力',它极大地降低了游戏开发中从'想法'到'实现'之间的摩擦。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online