
在人工智能飞速发展的今天,大语言模型早已不仅限于聊天和文本生成。它们开始能够使用工具,与环境进行交互,从而执行复杂任务。对于广大游戏开发者而言,这意味着一个全新的范式正在到来:用自然语言驱动 Unity 编辑器,让 AI 成为我们的结对编程伙伴。
本文介绍一个工具 Unity-MCP,将 Unity 接入 AI 开发游戏,解放我们的双手。
Unity-MCP 接入 AI 开发完整指南
什么是 MCP?
MCP 介绍
MCP(Model Context Protocol 模型上下文协议)可以想象成一个 AI 助手的'通用 USB-C 接口'。以前,每个 AI 应用要连接不同的数据源或工具,都需要专门的接口。
而 MCP 的目标是提供一个标准化的协议,让 AI 助手(比如 Claude、Cursor)能够通过这个'通用接口',方便、安全地连接并操控各种软件,其中就包括 Unity 编辑器。
一个典型的 Unity MCP 实现包含两部分:
- Unity 端插件:一个安装在你的 Unity 项目中的包,它在 Unity 编辑器里启动一个本地服务器(通常通过 WebSocket 或 TCP),监听并执行来自 AI 助手的命令。
- MCP 客户端连接器:一个运行在你电脑上的小程序(通常通过 Node.js 或 Python),它负责把你的 AI 助手(如 Claude Desktop)和 Unity 编辑器连接起来。你在 AI 对话框里提需求,它就把需求转成 Unity 能理解的指令。
可以把 Unity-MCP 想象成一个通用的翻译器和信使。它将 Unity 编辑器的复杂内部状态和功能,封装成一系列 AI 可以理解和调用的'工具'。从此,AI 不再只是'看'到你粘贴的代码片段,而是能真正'走进'你的项目,'看见'场景中的所有对象,'动手'修改属性甚至执行测试。
为什么要配置 MCP?
未连接 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 安装步骤
前提条件
在使用 MCP 之前需要一些前提条件,否则没办法正常使用。
- Git CLI:用于克隆服务器代码。下载 Git
- Python:3.12 或更高版本。下载 Python
- Unity Hub 及编辑器:2020.3 LTS 或更高版本。下载 Unity
- uv(Python 包管理器):pip install uv # 或参考:https://docs.astral.sh/uv/getting-started/installation/
- 支持 MCP 的 AI 客户端:(Claude Desktop、Cursor、VSCode 等)
Git 和 Unity 正常我们肯定都安装了,额外需要安装一下 Python 和 uv 即可。
安装 Unity-MCP 包(桥接组件)
- Window > Package Manager(窗口 > 包管理器)。
- 点击 + -> Add package from git URL…(从 git URL 添加包…)。
- 输入:
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 打开相关面板。

MCP 配置
如果前提条件都安装好了,打开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 端的准备就都完成了,下面是去 Trea(或其他 IDE) 中进行配置。

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

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

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

创建一个智能体并添加 Unity-MCP
打开 设置->智能体

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

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

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

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

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

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

这样我们一行代码都没有写,也没有手动操作 Unity,就完成了一个初级小功能。
总结
Unity-MCP 不仅仅是一个技术工具,它代表了一种人机协作的新范式。通过为 AI 提供标准化的'上下文'和'行动能力',它极大地降低了游戏开发中从'想法'到'实现'之间的摩擦。
- 对于开发者: Unity-MCP 让我们从繁琐的重复性劳动中解放出来,能更专注于创意和设计。开发者将成为一名


