unity-mcp

让 AI 直接动手操作 Unity 编辑器，用对话搞定场景和脚本

Unity MCP 是一个开源桥接工具，让 AI 助手（如 Claude、GPT）能直接操控 Unity 编辑器。它通过 Model Context Protocol 协议，为 LLM 提供管理资源、控制场景、编辑脚本和自动化任务的能力。开发者可以用自然语言指令让 AI 在 Unity 中创建物体、调整属性、运行测试，甚至批量处理资源，从而大幅提升游戏开发效率。它解决了传统 AI 无法直接与 Unity 交互的痛点，将 AI 的代码生成能力与 Unity 的实时环境结合，实现从对话到场景变更的闭环。核心能力包括：编辑器内工具调用、场景对象操作、C# 脚本生成与修改、资源导入导出、以及自定义工具扩展。适合希望用 AI 加速原型开发、自动化重复性工作的 Unity 开发者。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 14411

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队CoplayDev

所属国家

官网地址https://coplaydev.github.io/unity-mcp

GitHubhttps://github.com/CoplayDev/unity-mcp

定价模式free

价格说明开源项目，MIT许可证，完全免费，无付费版本。

访问状态

是否开源是

开源协议MIT

主要语言C#

技术栈/模型ai,ai-integration,anthropic,claude,copilot,cursor,game-development,gamedev,gemini,llm,mcp,model-context-protocol,openai,unity,unity3d,videogames

GitHub 星标★ 14411

30天Star增速

HF 下载量

上线时间2025-03-18 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 3 步

环境要求

Unity 2021.3 LTS ~ 6.x
Python 3.10+（通过 uv 管理）
任意 MCP 客户端：Claude Desktop/Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等

安装与启动步骤

1安装 Unity 包

Unity 打开 Package Manager → Add package from git URL，粘贴下方地址；或使用 openupm 命令安装。可在地址末尾用 #v10.0.0 固定版本。
```
openupm add com.coplaydev.unity-mcp
```
2配置 MCP 客户端

回到 Unity 编辑器，打开菜单 Window → MCP for Unity → Configure All Detected Clients，自动写入已检测到的客户端配置。
3发指令验证

在 AI 客户端中发送提示，让 AI 在 Unity 中创建物体。若场景内迅速出现立方体并带上刚体，说明桥接已打通。
```
Create a cube at the origin and add a Rigidbody.
```

关键配置

配置项	必填	说明	示例
`Package Git URL`	是	在 Unity Package Manager 中添加的 Git 地址，路径指向 /MCPForUnity	`https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity`

如何确认成功

向 AI 客户端发送“Create a cube at the origin and add a Rigidbody.”，数秒内 Unity 场景出现带 Rigidbody 的立方体即成功。

常见问题

Q：支持哪些 Unity 版本？

A：支持 Unity 2021.3 LTS 一直到 6.x，版本跨度较大，旧项目一般也能直接使用。

Q：可以用哪些 AI 客户端？

A：任何 MCP 客户端都可以，包括 Claude Desktop 与 Claude Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等。

Q：Python 环境有什么要求？

A：需要 Python 3.10 或更高版本，并按 README 要求通过 uv 来管理运行环境。

Q：怎么固定版本避免主分支更新？

A：把 Git URL 末尾的 #main 换成发布标签，例如 #v10.0.0，可锁定到对应发行版。

注意事项

README 未给出 uv 的安装命令，请自行参考 uv 官方文档完成安装。
默认使用 #main 主分支可能随更新变化，生产环境建议固定到 #v10.0.0 之类的版本标签。
配置由 Configure All Detected Clients 自动完成，需确保 AI 客户端已在同一机器上安装并可被检测到。
更多说明见官方 Wiki：https://coplaydev.github.io/unity-mcp/

核心亮点

直接调用 Unity 编辑器 API，AI 能实时创建/修改场景对象，而非只给代码建议
支持自定义工具扩展，开发者可按需暴露任意编辑器功能给 LLM
基于 MCP 标准协议，可无缝对接 Claude、GPT 等主流 AI 助手

不足之处

依赖网络请求与编辑器通信，复杂场景下可能有延迟或连接不稳定
文档/社区待观察：教程和示例相对有限，高级用法需自行摸索

适用场景

用自然语言快速搭建游戏原型场景，如'生成一个带刚体的立方体'
批量处理资源，如'将所有材质球的颜色改为红色'
辅助编写和重构 C# 脚本，AI 直接修改文件并触发编译

替代项目

Unity-Sentis、Unity-ML-Agents、Copilot for Unity

项目介绍

unity-mcp 是智能体领域的开源项目，由 CoplayDev 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（14,411）位列前 4%，在智能体分类的 2,517 个项目里位列前 5%。

近 41 天，它的 GitHub 星标从 13,352 增加到 14,411，净增 1,059。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，无付费版本。

它主要面向的使用场景是：用自然语言快速搭建游戏原型场景，如'生成一个带刚体的立方体'。同类可对比的替代方案包括 Unity-Sentis、Unity-ML-Agents、Copilot for Unity。

上一篇：RD-Agent

下一篇：trae-agent