Unity-MCP 实战指南：用 AI 直接操控 Unity 编辑器

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

环境搭建与安装

前提条件

在使用 MCP 之前需要一些前提条件，否则没办法正常使用。

• Git CLI：用于克隆服务器代码。
• Python：3.12 或更高版本。
• Unity Hub 及编辑器：2020.3 LTS 或更高版本。
• uv（Python 包管理器）：pip install uv # 或参考官方文档。
• 支持 MCP 的 AI 客户端：（Claude Desktop、Cursor、VSCode 等）

Git 和 Unity 正常我们肯定都安装了，额外需要安装一下 Python 和 uv 即可。

安装 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 打开相关面板。

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 IDE 配置

添加 MCP 配置

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

添加以下 MCP 配置

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

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

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

打开 设置->智能体

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

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

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

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

使用 AI 开发功能

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

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

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

总结

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

• 对于开发者：Unity-MCP 让我们从繁琐的重复性劳动中解放出来，能更专注于创意和设计。开发者将成为一名'AI 指挥家'，用自然语言引导 AI 完成复杂的开发任务。
• 对于 AI：Unity-MCP 赋予了它'手'和'眼'，让它从一个知识库变成一个真正的'代理'，能够在复杂的 Unity 环境中感知、决策并行动。

尽管目前 Unity 官方也在开发如 Muse 等原生 AI 工具，但基于开放协议 MCP 的 Unity-MCP 提供了更高的灵活性和可选择性，让我们可以自由地选择最适合自己的 AI 模型和客户端。

随着像 Coplay 这样的公司开始主导其开发，Unity-MCP 的未来路线图更加清晰，它正在迅速成为现代 AI 驱动型游戏开发工作流中不可或缺的一环。