用 Claude Code 与 Cursor 操作 Unity MCP：少手写引擎里的重复改动

「AI 只往文件夹里写 C#」的上限

对话式编程很擅长生成脚本。只改磁盘文件的 AI 辅助，仍然看不到活的编辑器状态——当前场景、选中物体、预制体变体、Play 模式行为、Console 报错。

如果模型只能看磁盘上的文件，它会猜层级，却点不了 Play、改不了 Hierarchy 里的节点、也查不到 Missing Reference。团队真正需要的是助手进入引擎循环，而不只停在仓库里。

Model Context Protocol（MCP） 是 AI 客户端调用工具的一种标准方式。Unity MCP 通过本地桥接暴露编辑器能力，让 Claude Code、Cursor、以及类似 Codex 的工作流在 Unity 运行时读写工程。

VberAI 提供 Unity MCP 插件作为这类桥接。本文走实用安装与使用路径，不做功能清单堆砌。

Unity MCP 改变日常的哪些事

没有 MCP	有 Unity MCP
粘贴生成脚本，再自己修编译错误	让客户端创建脚本并挂到指定 GameObject
手工复制 UI 面板	提示：「在 Canvas 下克隆 Panel_Shop 并重命名子节点」
在聊天里口述 Console 报错	在插件支持的范围内让客户端读日志 / 选中上下文
从 YAML 猜场景结构	先查 Hierarchy，再带着确认去改

你仍要审查改动、看 Play 结果。省掉的是那些代理可以安全完成的重复点击。

前置条件

• 已打开的 Unity 工程（团队协作建议 LTS）
• 支持 MCP 的客户端：Claude Code、Cursor、Windsurf 等
• 本机可访问 127.0.0.1（桥接通常只跑在回环地址）
• 对应 Unity 版本的 VberAI Unity MCP 包（下载 / 文档）

可选：准备一个小场景（空 Canvas + 两个按钮），方便验证首批提示。

安装清单

1. 安装 Unity MCP 插件

1. 将包导入工程（或按团队包管理流程安装）
2. 启用扩展 / 菜单项（不同构建名称略有差异，常见为 MCP 或 AI Bridge）
3. 如 Unity 提示，请重载编辑器

2. 启动本地 MCP 桥接

打开插件面板并启动服务，确认：

• 状态为 运行中
• 主机为 localhost（不要把端口暴露到公网）
• 工程路径就是你要改的那个 Unity 项目

3. 在 AI 客户端里注册服务

在 Cursor 或 Claude Code 中新增 MCP 服务，指向本地 Unity 桥接（stdio 或 HTTP/SSE，以插件当前文档为准）。

若工具列表未出现，重启客户端。应能看到与 Unity 相关的工具（读场景、节点操作等）。

4. 只读冒烟测试

提问：

列出当前活动场景的根级 GameObject。

回复若与 Hierarchy 一致，说明桥接正常。再尝试写入操作。

5. 小范围写入测试

提问：

在场景根下创建一个名为 MCP_SmokeTest 的空物体。

在 Hierarchy 里找到后删除。大范围重构前，优先做可逆试验。

更好用的提示写法

先结构

列出 Canvas/HUD 的子节点，并说明哪些是 LayoutGroup。

写入要聚焦

在 Canvas/Menu 下把 Button 重命名为 Btn_Start，并把 TMP 文案设为 开始。

调试闭环

我按下 Play 后，汇总与 PlayerController 相关的 Console 错误，并给最小修复建议。

配合已导入的 UI

若屏幕来自 AI Studio，可用 MCP 接 onClick、统一命名与 C# 约定——不必手拆预制体重搭。

安全习惯

• 桥接仅保留在 localhost
• 习惯「读 → 计划 → 写」，避免一条提示「重做整款游戏」
• 大改前先提交版本
• 不要把密钥写进提示；MCP 不能替代权限管理
• 把 Play 模式与资源刷新当作人工检查点

MCP 减少手动点引擎，不取消代码审查。

和市面上的 Unity AI 能力怎么比

厂商内置助手与第三方 Unity MCP 插件目标常有重叠。用同一套问题评估：

1. 能否看到实时 Hierarchy / 选中对象？
2. 改动是否可逆、可审计？
3. 能否接入团队已在用的客户端（Claude Code、Cursor 等）？

当团队已在这些客户端里工作时，Unity MCP 的价值最大；同一习惯也能延伸到 Godot / Cocos 的 MCP。

常见问题

还要不要写 C#？
要。MCP 擅长编辑器操作与脚手架。玩法系统、网络与性能仍需要工程师。

Claude Code 和 Cursor 选哪个？
只要支持 MCP 并指向同一本地 Unity 服务即可。选仓库已在用的客户端；桥接是共享部分。

是不是只适合 UI？
不是。层级、组件、场景操作同样适用于玩法物体。UI 只是最好验证的第一课。

有没有视频教程？
可参考 Unity 引擎 MCP 插件视频指南。

下一步

1. 在临时场景安装 Unity MCP
2. 连接 Claude Code 或 Cursor，通过只读冒烟测试
3. 自动化一件你讨厌的杂务（批量重命名、复制面板、挂脚本）

若瓶颈在设计稿到预制体，而不是编辑器操作，可搭配 Figma → Unity 的 AI Studio 流程。