Unity-MCP 使用指南：让 AI 连接并控制 Unity 编辑器

GitHub 下载地址：https://github.com/CoplayDev/unity-mcp

二、🚀MCP 安装步骤

2.1 前提条件

在使用 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 即可。

2.2 安装 Unity-MCP 包（桥接组件）

1. Window > Package Manager（窗口 > 包管理器）。
2. 点击 + -> Add package from git URL…（从 git URL 添加包…）。
3. 输入：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 打开相关面板。

2.3 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 端的准备就都完成了，下面是去 Trae(或其他 IDE) 中进行配置。

三、🎈Trae 配置

3.1 添加 MCP 配置

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

添加以下 MCP 配置

{"mcpServers":{"unityMCP":{"url":"http://localhost:8080/mcp"}}}

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

3.2 创建一个智能体并添加 Unity-MCP

打开 设置->智能体

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

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

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

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

3.3 使用 AI 开发功能

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

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

这样我们一行代码都没有写，也没有手动操作 Unity，就完成了一个初级小功能。

总结

Unity-MCP 不仅仅是一个技术工具，它代表了一种人机协作的新范式。通过为 AI 提供标准化的'上下文'和'行动能力'，它极大地降低了游戏开发中从'想法'到'实现'之间的摩擦。

• 对于开发者：Unity-MCP 让我们从繁琐的重复性劳动中解放出来，能更专注于创意和设计。开发者将成为一名