📌 项目地址:CoplayDev/unity-mcp |
⭐ 11,490 颗星 | 🔧 C# | 📜 未标注
半年前我试过一个工具:对着聊天框敲“把场景里所有材质颜色改成红色”,几秒后真变了。但当时那个工具只能改颜色,稍微复杂的操作就报错。
今天要说的这个叫 unity-mcp 的项目,把这事儿推进了一大步。GitHub 上
1.1 万星,最新版本 v10.0.0(2026年6月30日发布),MIT
许可证完全免费。
它做什么?
简单说:你在任何支持 MCP 协议的客户端(Claude、VS
Code、Cursor、Windsurf、Gemini CLI
等)里用自然语言下指令,它能直接操作你的 Unity 编辑器。
MCP(Model Context Protocol)是核心。它像个翻译器,把 AI 对 Unity
的理解转成编辑器能执行的命令。项目提供了 47
个“工具入口”,每个对应一类操作。所有工具目录在这里:https://coplaydev.github.io/unity-mcp/reference/tools/
这些工具覆盖什么? – 场景与物体:新建或删除
GameObject,改位置、旋转、缩放,加组件 –
资源管理:图片/模型导入,重命名,创建材质、预制体 –
C# 脚本:写新脚本,改代码,触发编译 –
测试与调试:开关播放模式,跑单元测试,读 Console 日志 –
构建打包:调 Build Settings,打出各平台版本 –
高级:多 Unity 实例同时使用(文档:Multi-Instance
Routing)
上手有多快?
按 README 的说法,三步走。
第一步:安装 Unity Package Manager 里加 Git
URL:
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
想锁定版本就把 #main 换成 #v10.0.0。或者用
OpenUPM 装:openupm add com.coplaydev.unity-mcp
第二步:配置 菜单栏
Window → MCP for Unity → Configure All Detected Clients。它会自动扫描并配置你电脑上已装的
MCP 客户端。
第三步:下指令 在 Claude 或 Cursor 里敲一句: >
“Create a cube at the origin and add a Rigidbody.”
几秒后场景里就会出现带刚体的立方体。
环境要求:Unity 2021.3 LTS 到 6.x 都行,Python
3.10+(依赖 uv 管理)。
比手动操作好在哪里?
我试了试最基础的:在场景里排 20 个位置不同的
Sphere,每个加不同材质。手动的话至少花五分钟反复拖拽、复制、改属性。用这个工具,一句话:“放20个球,坐标X从-10到10均匀分布,颜色渐变成蓝色到红色。”它搞定了,耗时大概三秒。
缺点也是有的。AI
对复杂逻辑的理解还很有限。比如让它写一个完整的 AI
寻路脚本并挂上去,目前报错率还挺高。建议从简单的操作开始,逐步验证。
社区与维护
项目由 Aura 赞助维护(Aura
本身也是个 Unity/Unreal 的 AI 助手)。社区活跃度从 release
频率就能看出来:2026年4月到6月发了4个版本,v10.0.0 和 v9.6.8
就隔了两个月。
交流渠道:Issues 提 bug/需求,Discussions 聊设计思路,Discord(链接)找维护者直接聊。贡献代码的话,注意分支要基于
beta,不是 main。
说点实在的
如果你是独立开发者,每天花大量时间在场景搭建和资源导入上;或者团队想给
CI/CD
加个自动化测试流程——这个项目值得花半小时试试。装好之后,很多重复性的编辑器操作完全可以扔给
AI 做。
但别指望它替你写全部的逻辑代码。目前它的强项在“体力活”上:批量创建、修属性、跑测试。复杂的设计决策和业务逻辑,还得自己来。
安装链多了一个 uv(Python 包管理工具),需要提前配好
Python 3.10+。多实例和工具分组这类高级玩法,建议先翻翻 Wiki 文档(https://coplaydev.github.io/unity-mcp/)。
想试就直接装,开箱就能用。