CoplayDev/unity-mcp

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

MCP for Unity – AI 驱动的 Unity 编辑器控制

它是什么

一个开源 Unity 包，让您可以与大型语言模型（Claude、Codex、Gemini、本地 LLM 等）对话，并让它们为您操作 Unity 编辑器。它实现了 模型上下文协议（MCP），因此任何兼容 MCP 的客户端都可以发出自然语言命令。

主要功能

场景和 GameObject 创建 – 让模型添加立方体、灯光、预制件等。
C# 脚本编辑 – 生成或修改脚本，并使用 Roslyn 验证在脚本到达编辑器之前捕获语法错误。
资源管理 – 通过聊天导入、移动、重命名或删除资源。
测试和分析 – 运行单元测试、启动分析会话并检索结果。
构建自动化 – 为任何目标平台触发构建。
工具目录 – 50 个预定义的“工具入口点”，涵盖 UI、VFX、动画、测试等。
多实例路由 – 从单个客户端控制多个 Unity 编辑器实例。
远程服务器模式 – 在另一台机器上托管 MCP 桥接器，并带有身份验证。

如何开始

在 Unity 的包管理器中添加包，使用 git URL：
```
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
```
（固定一个标签，如 #v10.0.0 以获得稳定版本，或使用 OpenUPM：openupm add com.coplaydev.unity-mcp）。
打开 Window → MCP for Unity → Configure All Detected Clients – UI 会扫描已安装的 MCP 客户端（Claude Desktop、Cursor、VS Code 等）并设置通信桥接器。
在任何 MCP 客户端中，输入自然语言提示，例如 “在原点创建一个立方体并添加一个 Rigidbody。” – 立方体将在几秒钟内出现在场景中。

适用对象

希望通过用自然语言描述更改来更快地进行原型设计或迭代的游戏开发者。
正在试验 AI 辅助内容创建流程的工作室。
研究 3D 创作环境中人机交互的研究人员。

社区和支持

Discord 用于实时帮助和功能讨论。
GitHub Issues 和 Discussions 用于错误报告、功能请求和设计想法。
详细的文档、迁移指南和完整的工具参考托管在 https://coplaydev.github.io/unity-mcp/。

许可证

MIT – 免费用于商业和非商业用途。

相关项目

Aura（赞助商）为 Unity/Unreal 提供高级 AI 助手。
同一团队维护 Godot AI，这是针对 Godot 引擎的类似工具。

如果您在研究中使用 MCP for Unity，请引用随附的 ACM 论文（Wu & Barnett, 2025）。