Unity MCP教程:14.4k星AI助手与Unity编辑器桥接,自然语言控制游戏开发

📌 项目:CoplayDev/unity-mcp | 星数:14.4k(2026-09-24) | 协议:MIT | 语言:C# | GitHub

一句话定位:"让AI助手直接操作Unity编辑器——说一句话,创建场景、调整材质、生成脚本。" Unity MCP是AI助手与Unity Editor的MCP桥接器,通过标准MCP协议暴露Unity编辑器操作,让Claude、Cursor等AI工具能直接操控Unity。

🌉 桥接原理

Unity MCP在AI助手和Unity Editor之间建立MCP协议桥接:

AI可以执行的操作包括:创建/删除游戏物体、调整Transform、修改材质属性、创建/运行场景、生成C#脚本、调用Unity菜单命令等。和 Chrome DevTools MCP 桥接浏览器类似,Unity MCP桥接游戏引擎。

🚀 快速开始

# 1. Unity Package Manager安装
# Unity → Package Manager → Add from Git URL
# https://github.com/CoplayDev/unity-mcp.git

# 2. Unity菜单 → MCP → Start Server

# 3. 配置Claude Code MCP
cat >> ~/.claude/mcp.json << EOF
{
  "mcpServers": {
    "unity": {
      "command": "node",
      "args": ["unity-mcp-bridge"]
    }
  }
}
EOF

之后在Claude Code中说"创建一个红色立方体在原点",AI会通过MCP调用Unity API完成。

🎮 典型用例

# 自然语言指令示例
"创建一个名为Player的空物体,添加Rigidbody组件"
"把场景中所有蓝色材质改成红色"
"生成一个玩家移动脚本,WASD控制"
"运行当前场景并截图"
"把Directional Light的强度调到0.5"

AI理解自然语言意图,翻译为Unity API调用,在编辑器中实时执行。

⚖️ 优缺点

✅ 优点⚠️ 不足
自然语言控制Unity编辑器,降低游戏开发门槛复杂操作AI可能理解不准确
MCP标准协议,兼容主流AI助手需要Unity Editor运行中
暴露完整Unity API能力C#脚本生成质量取决于AI模型
实时反馈,所见即所得
MIT协议

📚 常见问题

支持哪些AI助手?

支持所有MCP协议客户端:Claude Code、Cursor、Windsurf等。只要配置了MCP服务器连接即可。

能生成完整的Unity游戏吗?

Unity MCP擅长场景搭建、物体操作和简单脚本生成。完整游戏需要更多手动工作,但AI能大幅加速重复性任务。

需要在Unity Editor中运行吗?

是的,Unity MCP的C#脚本在Editor中运行,需要Editor启动并开启MCP Server。