一、项目介绍

做 Unity 游戏开发，最尴尬的是“AI 能写代码，却碰不到编辑器”：想让 Agent 在场景里放个物体、改个组件、跑一次构建，都得人肉来回切窗口。你只想要一个懂 Unity 的 AI 助手，却被编辑器壁垒卡住。
Unity-MCP 是一套把 Unity 编辑器暴露成 MCP 服务的方案。它提供命令行脚手架与一个“AI Game Developer”插件，让 Claude、Gemini 等 AI 客户端直接读写场景、调用编辑器 API，把游戏开发流程接进智能体。

二、项目基本信息

信息项详情
项目名称Unity-MCP
GitHub地址https://github.com/IvanMurzak/Unity-MCP
项目描述AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.
作者IvanMurzak
开源协议Apache License 2.0
开源状态公开
LanguagesC#
支持平台Windows / macOS / Linux
最后更新2026-10-30

三、核心优势

  • 编辑器能力封装为 MCP，AI 客户端即调即用地操作 Unity
  • 提供 unity-mcp-cli 脚手架，安装插件一步到位
  • 支持 Claude、Gemini 等多家 MCP 客户端
  • 同时提供 Docker 镜像，便于远程/CI 接入
  • 开源可改，可扩展自定义编辑器工具

四、适用场景

适合用 AI 辅助做 Unity 游戏开发、希望让智能体直接操作场景与编辑器、减少手动切窗的团队。

五、安装教程

当前最新版本 latest。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 1. 安装脚手架
npm install -g unity-mcp-cli
# 2. 在 Unity 工程里安装 AI Game Developer 插件
unity-mcp-cli install-plugin ./MyUnityProject

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 安装插件后，在支持 MCP 的客户端添加该服务（以 Gemini 为例）
gemini mcp add ai-game-developer <command>
# 也可走 Docker 拉起 MCP 服务
docker run -p 8080:8080 aigamedeveloper/mcp-server
# 之后直接对客户端说：在场景里新建一个 Cube 并加上 Rigidbody

七、常见问题

问：需要打开 Unity 编辑器吗？答：需要编辑器运行并加载插件，MCP 才能连接到工程。问：支持哪些客户端？答：任何 MCP 兼容客户端，如 Claude、Gemini 等。

八、总结

Unity-MCP 用一个清晰的设计，把把第三方能力安全收拢到统一控制面这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。