unity-mcp
通过Model Context Protocol将AI助手与Unity编辑器连接的桥梁,让LLM能直接管理场景、资源、脚本和自动化工作流。提供47个MCP工具入口,支持Claude、Cursor、VS Code等多种AI客户端,免费MIT开源,且由Aura团队维护并采用学术论文引用。项目与Unity无关,仅供开发使用。
README
由 Aura — 面向 Unreal 与 Unity 的 AI 助手 — 自豪地赞助与维护。
别忘了 Godot AI,这是 MCP for Unity 制作团队的新开源项目。
用 LLM 创建你的 Unity 应用。 MCP for Unity 通过 Model Context Protocol 将 AI 助手 — Claude、Codex、VS Code、本地 LLM 等 — 与你的 Unity Editor 连接起来。为你的 LLM 提供工具,用于管理资源、控制场景、编辑脚本、运行测试以及自动化游戏开发工作流程。
近期更新
- v10.0.0 (2026-06-30)
- v9.7.3 (2026-06-15)
- v9.7.1 (2026-05-24)
- v9.7.0 (2026-05-22)
- v9.6.8 (2026-04-27)
完整历史:发布说明
它能做什么
通过任何 MCP 客户端用自然语言控制 Unity Editor — 创建场景和 GameObject、编辑 C# 脚本、管理资源、运行测试、性能分析以及构建。47 个专注的 MCP 工具入口点,任意客户端,免费且基于 MIT 协议。
快速开始
要求: Unity 2021.3 LTS → 6.x · Python 3.10+(通过 uv)。适用于任意 MCP 客户端 — Claude Desktop & Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等。
- 安装 — Unity → Package Manager → 从 Git URL 添加:
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main(钉选#v10.0.0以获取此版本,或openupm add com.coplaydev.unity-mcp) - 配置 —
Window → MCP for Unity → 配置所有检测到的客户端。 - 提示 — "在原点创建一个立方体并添加 Rigidbody。" 数秒内立方体即出现。
社区
- Discord — 与维护者及其他贡献者交流
- Issues — 报告 Bug 与功能请求
- Discussions — 设计思路与更广泛的问题
- 安全:请参阅 SECURITY.md 了解私下报告方式
贡献
请参阅 CONTRIBUTING.md。在 beta 分支(而非 main)上创建分支。完整的开发环境配置、测试和发布流程详见贡献文档。
高级功能
- 多 Unity 实例 — 多实例路由
- 工具组(vfx / animation / ui / testing 等) — 工具组
- v10 资源生成与升级说明 — v10 迁移
- Roslyn 脚本验证 — Roslyn 验证
- 远程服务器(带认证) — 远程服务器认证
Star 历史
引用
如果 MCP for Unity 对你的研究有所帮助,请引用它。
@inproceedings{wu2025mcpunity,
author = {Wu, Shutong and Barnett, Justin P.},
title = {{MCP-Unity}: {Protocol-Driven} Framework for Interactive {3D} Authoring},
year = {2025},
isbn = {9798400721366},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
url = {https://doi.org/10.1145/3757376.3771417},
doi = {10.1145/3757376.3771417},
series = {SA Technical Communications '25}
}
Aura 的 Unity AI 工具
Aura 提供 2 个 Unity AI 工具:
- MCP for Unity 基于 MIT 协议免费提供。
- Aura for Unity 是一款面向游戏开发者的高级 Unity/Unreal AI 助手。
免责声明
本项目是一款面向 Unity Editor 的免费开源工具,与 Unity Technologies 无关。
许可证: MIT — 参见 LICENSE。