Unity MCP:让 Claude 直接操作 Unity 编辑器
"建对象、连组件、写脚本,一句话说完就帮你做完"——CoplayDev 的开源 MCP for Unity 是 AI 与主流引擎深度结合的代表作,而且是本地运行:代码不出你的机器。
本文依据
基于 DeepWiki 对 CoplayDev/unity-mcp(约 1.6 万星)的源码级分析整理。架构、工具目录与安装要求均来自官方文档。
它是什么、怎么连
MCP for Unity 是一个开源桥接器:让 Claude Code、Cursor 等 AI 助手通过 Model Context Protocol 直接操作 Unity 编辑器。链路是——AI 客户端发出 MCP 请求 → Python MCP 服务器 → 转发给 Unity Editor 包 → 通过 Unity Editor API 执行。支持两种连接方式:HTTP(Unity 用 WebSocket 连服务器)与 stdio(本地 TCP 桥接)。
安装两步:①通过 Package Manager 的 Git URL(或 OpenUPM)装 Unity 包;②打开 Window → MCP for Unity,用 Auto-Setup 自动配置检测到的客户端(也可手动注册 Claude Code / 配置 Cursor)。前置要求:Unity 2021.3 LTS 及以上、Python 3.10+、uv/uvx。
本地运行,代码不出门
默认 HTTP 配置走 localhost,stdio 配置用 uvx 本地启动——AI 在你自己的项目里干活,权限握在自己手上,不用把代码传到任何第三方。Docker 与远程 HTTP 托管是可选项,不是必需。
工具目录:47 个入口
| 工具 | 能做什么 |
|---|---|
| manage_gameobject | 创建、修改、变换、删除 GameObject |
| manage_components | 添加/移除组件、设置组件属性 |
| manage_scene | 加载、保存场景,查询层级结构 |
| create_script / script_apply_edits / validate_script | 创建 C# 脚本、应用编辑、编译校验 |
| 其余工具组 | 资产、预制体、材质、物理、测试、构建等 |
文档化的工作流细节很讲究:等 Unity 的导入/编译完成、检查 Console 无报错之后,才把新脚本挂到 GameObject 上——这就是"AI 改完代码立刻能玩"的技术保障。
与 AI 工作室生态的关系
- 与 Game Studios:Claude-Code-Game-Studios 模板里就为 Unity 设了专门的 specialist 智能体(见 角色分工)——MCP 提供的是"手",技能包提供的是"脑";
- 与技能包生态:awesome-gamedev-agent-skills 有 8 个 Unity 专项技能(含 unity-scriptableobjects),见 技能包专题;
- 同类对照:ModRetro Chromatic 的 Claude 移植版走的是同一模式(MCP 工具 + 技能 + 钩子),对象换成了 GB 游戏(见 Chromatic 移植版)。
坑位清单
batch_execute可以把多个操作打包成一次请求,但明确是非事务性的——别假设失败会整体回滚;- 部分功能依赖可选 Unity 包:高级 Cinemachine 操作需要
com.unity.cinemachine;非核心工具组默认是 opt-in; - 客户端差异:Claude Desktop 仅支持 stdio;Cursor 配置后可能需要手动启用 MCP 设置;
- 本地环境别忘三件套:Unity 2021.3+、Python 3.10+、uv/uvx。