Unity MCP 简介
Unity MCP 是一个开源项目,通过模型上下文协议(MCP)在大型语言模型和 Unity 编辑器之间建立沟通桥梁。该工具允许开发者使用自然语言指令操作 Unity,实现 AI 驱动的开发体验。
核心优势与特色功能
Unity MCP 能够将 AI 助手(如 Claude、Cursor 等)直接连接到 Unity 编辑器。主要功能包括:
- 智能场景管理:通过自然语言加载、保存和创建场景
- 脚本自动化操作:创建、读取、更新和删除 C# 脚本
- 资产全流程控制:从导入到修改的一站式资产管理
- 着色器快速生成:使用 CGProgram 模板自动创建专业着色器
- 游戏对象智能处理:管理 GameObject 的创建、修改和组件操作
系统要求与前置准备
开始使用前,请确保开发环境满足以下要求:
必备组件:
- Unity Hub & Editor 2020.3 LTS 或更新版本
- Python 3.12 或更新版本
- Git CLI 用于克隆服务器代码
- uv 包管理器(Python 包管理工具)
支持的 MCP 客户端:
- Claude Desktop
- Claude Code
- Cursor
- Visual Studio Code Copilot
分步安装指南
第一步:安装 Unity 包(桥接器)
- 打开你的 Unity 项目
- 进入
Window > Package Manager - 点击
+->Add package from git URL... - 输入:
https://gitcode.com/gh_mirrors/un/unity-mcp.git?path=/UnityMcpBridge - 点击
Add完成安装
第二步:配置 MCP 客户端
推荐方法:自动配置
- 在 Unity 中,进入
Window > Unity MCP - 在你使用的 IDE 上点击
Auto Configure - 寻找绿色状态指示器和"Connected"提示
备用方法:手动配置
如果自动配置失败,可以手动编辑 MCP 客户端的配置文件:
Windows 示例配置:
{
"mcpServers": {
"UnityMCP": {
"command": "uv",
"args"

