IvanMurzak/Unity-MCP

Unity-MCP – AI 驱动的游戏开发助手

它是什么 – 一个 Unity 包，允许您将大型语言模型（LLM）代理（如 Claude、OpenAI Codex、Cursor、GitHub Copilot、Gemini 等）连接到 Unity 编辑器以及运行时构建的游戏。该插件公开了一组“MCP 工具”（70 多个内置命令），AI 代理可以调用这些命令来操作资产、场景、GameObject、脚本、包、编辑器状态，甚至运行性能分析查询。

主要功能

• 编辑器端 AI – 让 LLM 直接从 Unity 窗口创建对象、编写脚本、运行测试或调试问题。
• 运行时 AI – 可以从编译后的游戏内部进行相同的 LLM 调用，从而实现动态 NPC 行为或游戏内调试。
• 供应商无关的代理 – 适用于 Anthropic、OpenAI、Microsoft 以及任何其他支持 MCP 协议的提供商；无锁定。
• 可扩展的工具系统 – 开发人员可以用 C# 添加自定义工具或提示，并将其暴露给 AI。
• 自动技能生成 – 插件扫描项目（Unity 版本、已安装的包、操作系统）并构建一个 AI 可以使用的“技能集”，无需手动配置。
• 多种部署模式 – MCP 服务器可以通过 stdio 在本地运行，通过 HTTP 运行，或在 Docker 容器中运行。

如何开始

1. 安装插件 – 从 Releases 页面下载 AI-Game-Dev-Installer.unitypackage，或运行 CLI：

   npm install -g unity-mcp-cli
   unity-mcp-cli install-plugin ./MyUnityProject
   

2. 选择 AI 代理 – Claude、Codex、Cursor、Copilot、Gemini 等（UI 会列出支持的代理）。
3. 配置代理 – 在 Unity 中打开 Window → AI Game Developer，点击 Auto-generate skills，或运行 CLI 命令 unity-mcp-cli setup-skills claude-code ./MyUnityProject。
4. 与 AI 对话 – 输入自然语言命令，如 “Create three cubes in a circle with radius 2”，然后观察编辑器执行相应的 MCP 工具。

典型工作流示例

• 生成并放置预制体，修改组件字段，或即时创建新脚本。
• 自动运行 Unity Play-Mode 或 Edit-Mode 测试，并获得失败摘要。
• 捕获场景或相机的截图以进行视觉调试。
• 使用基于反射的调用从 AI 调用任何 C# 方法（甚至私有方法）。
• 部署 Docker 化的 MCP 服务器，让远程 LLM 在已发布的游戏中驱动 NPC 对话。

生态系统与扩展 核心包可以通过可选的技能包进行扩展，这些技能包为特定的 Unity 子系统添加工具：

• AI Animation、AI Cinemachine、AI InputSystem、AI Navigation、AI ParticleSystem、AI ProBuilder、AI Splines、AI Terrain、AI Tilemap、AI Timeline。 每个包都有自己的仓库（例如 Unity-AI-Animation），可以通过 Unity Package Manager 安装。

安装选项

• Unity Package Manager – openupm add com.ivanmurzak.unity.mcp
• CLI – unity-mcp-cli install-plugin …
• Docker 镜像 – aigamedeveloper/mcp-server 用于无头服务器部署。

许可证 – 该仓库根据 MIT 许可证发布。

谁可能使用它

• 希望快速原型开发而无需编写样板代码的独立开发者。
• 希望将 LLM 驱动的 NPC 或调试工具直接嵌入已发布游戏的团队。
• 在 Unity 中演示 AI 辅助游戏开发的教育工作者。

---

所有细节均取自项目的 README；没有推断任何额外功能。