Unity-MCP 配置指南：实现 AI 驱动游戏开发

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

MCP 面板

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) 中进行配置。

IDE 配置

三、Trae 配置

3.1 添加 MCP 配置

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

设置入口

添加以下 MCP 配置

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

配置内容

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

功能列表

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

打开 设置->智能体

智能体设置

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

内置智能体

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

勾选 MCP

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

对话界面

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

模型选择

3.3 使用 AI 开发功能

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

指令输入

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

运行效果

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

总结

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

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