Unity MCP 安装教程：Package Manager 导入并连接 AI IDE

本教程能帮你完成什么

跟着下面五步，你可以把 Unity MCP（VberAI Pro）接到本机 Unity 工程，并让 Cursor（或其他支持 MCP 的 AI IDE，操作类似）直接操作、预览、调试编辑器——而不只是改磁盘上的脚本文件。

完成后你应能：

• 通过 Package Manager「从磁盘添加包」导入 Unity MCP
• 用 VberAI 账号或邮箱激活码完成激活
• 启动本地 Unity MCP Server（默认端口 6589）
• 用「快速配置 → 自动配置」把服务写进 Cursor，并确认连接成功

产品页：VberAI Unity MCP

本文以 Cursor 为例；Claude Code、Windsurf、Cline 等 MCP 客户端的勾选与连接步骤类似。

前置条件

项目	说明
Unity	建议 2022.3+ / Unity 6（以官网当前支持说明为准）
插件包	官网下载的 Unity MCP Pro 压缩包，并已解压
激活方式	VberAI 账号 + 密码，或邮箱 + 激活码
AI IDE	推荐 Cursor；也可用其他支持 MCP 的客户端
本机网络	MCP 桥接通常跑在 127.0.0.1，勿把端口暴露到公网

步骤 1：下载 Unity MCP

在 VberAI 官网下载 Pro 版本：

下载页： https://www.vberai.com/game-engines/unity?ch=CQZLC2FG

建议：

1. 打开上述页面，按账号权限下载 Unity MCP Pro 压缩包
2. 将压缩包保存到本机，并解压缩到固定目录（下一步会选其中的 package.json）
3. 确认解压后目录中能看到 package.json，再进入 Unity

开源版与 Pro 的差异、订阅说明以官网当前说明为准。

步骤 2：导入插件

1. 打开目标 Unity 工程
2. 菜单栏点击 窗口（Window）→ 包管理器（Package Manager）
3. 在包管理器面板点击左上角 「+」
4. 选择 「从磁盘添加包」（Add package from disk）
5. 选中步骤 1 解压目录下的 package.json 文件并确认

导入成功后，Package Manager 列表中应能看到 Unity MCP 相关包。

步骤 3：激活 unity-mcp

1. 菜单栏点击 窗口（Window）→ Unity MCP → Mcp Panel
2. 在激活界面任选一种方式：
   • 输入 VberAI 账号 + 密码 登录激活
   • 或输入 邮箱 + 激活码 完成激活
3. 激活成功后再进入 MCP Server 设置页（下一步）

未激活时通常无法正常启动服务；请确认账号套餐或激活码对应当前 Pro 版本。

步骤 4：启动 unity-mcp-server

1. 激活成功后，进入 Unity MCP Server 设置页面
2. 按需调整：
   • 端口：默认 6589
   • 语言：按界面习惯选择
   • 启动状态：可按面板选项设置（例如是否随编辑器自动启动，以实际 UI 为准）
3. 点击 「启动服务」
4. 当面板出现 「运行中」 提示时，说明 Unity MCP Server 已启动成功

此时本机已有可用的 MCP 桥接，接下来把它交给 AI IDE。

步骤 5：一键配置 AI IDE（以 Cursor 为例）

1. 点击 「工具管理」
   • 查看 Unity MCP Server 暴露的工具列表
   • 按需要勾选你希望 AI 使用的能力
2. 点击 「快速配置」
   • 选择目标 IDE（例如 Cursor）
   • 点击 「自动配置」
   • 确认界面显示为 已配置 状态
3. 打开 Cursor
   • 在 MCP / 工具列表中应能看到 unity-mcp 已自动连接
   • 若尚未出现，在 Cursor 中点击 「重新加载」（或等价的 MCP 重载操作）后再看一次

其他 AI IDE 的选择与自动配置流程类似，只需在「快速配置」里换成对应客户端。

连接成功后的快速验证

在 Cursor 中可先做一次只读确认，例如：

列出当前 Unity 打开场景的根节点（Hierarchy 顶层对象）。

若回复与编辑器 Hierarchy 一致，说明桥接正常。再尝试小范围写入（如新建临时空物体并删除），确认权限与工具勾选符合预期。

常见问题

「从磁盘添加包」找不到 package.json？
确认步骤 1 已完整解压，且选中的是解压目录根层的 package.json，而不是多余嵌套目录里的文件。

激活一直失败？
核对账号是否已开通对应 Pro 权益，或激活码是否过期、是否绑定了正确邮箱。可在官网账号中心核对后再回到 Mcp Panel 重试。

点了「启动服务」但没有「运行中」？
确认端口 6589（或你改过的端口）未被占用；关闭防火墙对 localhost 的误拦后再试。确认步骤 3 已激活成功。

Cursor 里看不到 unity-mcp？
回到 Unity 面板确认服务仍为「运行中」，再执行「快速配置 → 自动配置」；最后在 Cursor 中重新加载 MCP。仍失败时，核对 Cursor 的 MCP 配置是否写入了本地桥接地址。

下一步

• 用自然语言做一次场景查询或小改动，熟悉工具边界
• 大改前先提交版本；桥接仅保留在本机 localhost
• 若还在做设计稿到引擎 UI，可搭配 VberAI AI Studio 处理 Figma / PSD 交接，再用 MCP 做编辑器内迭代

更多 Unity + MCP 背景也可参考站内 Unity MCP 视频指南、用 Claude Code / Cursor 操作 Unity MCP。