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

一、🧐 MCP 是什么？

1.1 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 不再只是'看'到你粘贴的代码片段，而是能真正'走进'你的项目，'看见'场景中的所有对象，'动手'修改属性甚至执行测试。

1.2 为什么要配置 MCP？

未连接 MCP 时，AI 也可以直接在 Unity 中操作，但是连接 MCP 之后更安全和便捷。

MCP 让 AI 从一个被动的'顾问'转变为一个主动的'协作者'的关键技术，Unity-MCP 将这种变革性的能力带入了游戏开发领域。

1.3 效果展示

指令	效果

1.4 使用说明及下载

目前市面上有多款 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 安装步骤

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 包（桥接组件）

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

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 让我们从繁琐的重复性劳动中解放出来，能更专注于创意和设计。开发者将成为一名

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