CoplayDev/unity-mcp
GitHub: CoplayDev/unity-mcp
Unity MCP 是一个通过自然语言让 AI 助手直接控制 Unity 编辑器的协议桥接框架，旨在将 LLM 能力引入 3D 开发工作流以实现自动化创作。
Stars: 11729 | Forks: 1269
[English](README.md) 
[简体中文](docs/i18n/README-zh.md) | [Discord](https://discord.gg/y4p8KfzrN4) [Wiki](https://coplaydev.github.io/unity-mcp/)
## 功能
通过任何 MCP 客户端使用自然语言控制 Unity 编辑器 —— 创建场景和 GameObject、编辑 C# 脚本、管理资产、运行测试、进行性能分析以及构建项目。提供 47 个专属的 MCP 工具入口，支持任何客户端，免费且采用 MIT 协议。
**[浏览完整工具目录 →](https://coplaydev.github.io/unity-mcp/reference/tools/)**
## 快速入门
**环境要求：** Unity **2021.3 LTS → 6.x** · Python **3.10+**（通过 [`uv`](https://docs.astral.sh/uv/)）。支持**任何 MCP 客户端** —— Claude Desktop & Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等。
1. **安装** —— Unity → Package Manager → Add from git URL：
`https://github.com/Coplaydev/unity-mcp.git?path=/MCPForUnity#main` _（为此版本固定使用 `#v10.0.0`，或使用 `openupm add com.coplaydev.unity-mcp`）_
2. **配置** —— `Window → MCP for Unity → Configure All Detected Clients`。
3. **提示** —— *“在原点创建一个立方体并添加一个 Rigidbody。”* 立方体会在几秒钟内出现。
## 进阶
- **多个 Unity 实例** —— [多实例路由](https://coplaydev.github.io/unity-mcp/guides/multi-instance)
- **工具组（vfx / animation / ui / testing 等）** —— [工具组](https://coplaydev.github.io/unity-mcp/guides/tool-groups)
- **v10 资产生成与升级说明** —— [v10 迁移指南](https://coplaydev.github.io/unity-mcp/migrations/v10)
- **Roslyn 脚本验证** —— [Roslyn 验证](https://coplaydev.github.io/unity-mcp/guides/roslyn)
- **带身份验证的远程托管服务器** —— [远程服务器身份验证](https://coplaydev.github.io/unity-mcp/guides/remote-server-auth)
## 引用
如果 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 为 Unity 提供了 2 款 AI 工具：
- **MCP for Unity** 在 MIT 许可证下免费提供。
- **Aura for Unity** 是一款专为游戏开发者打造的高级 Unity/Unreal AI 助手。
## 免责声明
本项目是一款用于 Unity 编辑器的免费开源工具，与 Unity Technologies 无关。
**许可证：** MIT —— 详见 [LICENSE](LICENSE)。
[简体中文](docs/i18n/README-zh.md) | [Discord](https://discord.gg/y4p8KfzrN4) [Wiki](https://coplaydev.github.io/unity-mcp/)
## 功能
通过任何 MCP 客户端使用自然语言控制 Unity 编辑器 —— 创建场景和 GameObject、编辑 C# 脚本、管理资产、运行测试、进行性能分析以及构建项目。提供 47 个专属的 MCP 工具入口，支持任何客户端，免费且采用 MIT 协议。
**[浏览完整工具目录 →](https://coplaydev.github.io/unity-mcp/reference/tools/)**
## 快速入门
**环境要求：** Unity **2021.3 LTS → 6.x** · Python **3.10+**（通过 [`uv`](https://docs.astral.sh/uv/)）。支持**任何 MCP 客户端** —— Claude Desktop & Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等。
1. **安装** —— Unity → Package Manager → Add from git URL：
`https://github.com/Coplaydev/unity-mcp.git?path=/MCPForUnity#main` _（为此版本固定使用 `#v10.0.0`，或使用 `openupm add com.coplaydev.unity-mcp`）_
2. **配置** —— `Window → MCP for Unity → Configure All Detected Clients`。
3. **提示** —— *“在原点创建一个立方体并添加一个 Rigidbody。”* 立方体会在几秒钟内出现。
## 进阶
- **多个 Unity 实例** —— [多实例路由](https://coplaydev.github.io/unity-mcp/guides/multi-instance)
- **工具组（vfx / animation / ui / testing 等）** —— [工具组](https://coplaydev.github.io/unity-mcp/guides/tool-groups)
- **v10 资产生成与升级说明** —— [v10 迁移指南](https://coplaydev.github.io/unity-mcp/migrations/v10)
- **Roslyn 脚本验证** —— [Roslyn 验证](https://coplaydev.github.io/unity-mcp/guides/roslyn)
- **带身份验证的远程托管服务器** —— [远程服务器身份验证](https://coplaydev.github.io/unity-mcp/guides/remote-server-auth)
## 引用
如果 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 为 Unity 提供了 2 款 AI 工具：
- **MCP for Unity** 在 MIT 许可证下免费提供。
- **Aura for Unity** 是一款专为游戏开发者打造的高级 Unity/Unreal AI 助手。
## 免责声明
本项目是一款用于 Unity 编辑器的免费开源工具，与 Unity Technologies 无关。
**许可证：** MIT —— 详见 [LICENSE](LICENSE)。标签：DLL 劫持, MCP, SOC Prime, Unity, 大语言模型, 开发工具, 网络空间测绘, 网络调试, 自动化, 逆向工具