Unity MCP Package
2025.04.09
1623
C#Unity 开发自动化工具LLM 集成开发效率
Unity MCP Package 是一个 Unity 包，用于实现 Unity 与大型语言模型（LLMs）如 Claude Desktop 之间的无缝通信。通过 Model Context Protocol (MCP)，该服务作为桥梁，允许 Unity 发送命令到 MCP 兼容工具并接收响应，从而赋能开发者自动化工作流程、操作资产以及通过编程控制 Unity 编辑器。
View on GitHub
Overview
基本能力
产品定位
Unity MCP Package 旨在为 Unity 开发者提供一个与大型语言模型（LLMs）交互的平台，实现 Unity 编辑器与外部工具的自动化通信，提升开发效率和自动化能力。
核心功能
- 双向通信：Unity 与 LLMs 之间的无缝数据发送和接收。
- 资产管理：导入资产、实例化预制件、创建新预制件。
- 场景控制：打开、保存和修改场景，创建和操作游戏对象。
- 材质编辑：轻松应用和修改材质。
- 脚本集成：在 Unity 内创建、查看和更新 C# 脚本。
- 编辑器自动化：自动化 Unity 编辑器任务，如构建项目或进入播放模式。
适用场景
- 开发者希望通过 LLMs 增强 Unity 项目。
- 自动化重复性任务，如资产管理和场景控制。
- 通过编程方式控制 Unity 编辑器功能。
工具列表
- uv 包管理器：简化 Python 依赖管理。
- Python 3.12 或更高版本：运行 MCP 服务器的必备环境。
- Unity 2020.3 LTS 或更高版本：支持 URP 项目的 Unity 版本。
常见问题解答
- Unity Bridge 未运行：确保 Unity 编辑器已打开且 MCP 窗口处于活动状态，必要时重启 Unity。
- Python 服务器未连接：验证 Python 和 uv 是否正确安装，以及 Unity MCP 包是否设置正确。
- Claude Desktop 或 Cursor 配置问题：确保 MCP 客户端配置为与 Unity MCP 服务器通信。
使用教程
使用依赖
- 安装 Python 3.12 或更高版本：从 python.org 下载并安装，确保安装时添加到系统 PATH。
- 安装 uv 包管理器：
- Mac：
brew install uv - Windows：
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"，然后添加set Path=%USERPROFILE%\.local\bin;%Path%到 PATH。 - Linux：
curl -LsSf https://astral.sh/uv/install.sh | sh
安装教程
- 打开 Unity，进入
Window > Package Manager。 - 点击
+按钮，选择Add package from git URL。 - 输入：
https://github.com/justinpbarnett/unity-mcp.git。
调试方式
- 确保 Unity 编辑器已打开且 MCP 窗口处于活动状态。
- 验证 Python 服务器是否正常运行。
- 检查 MCP 客户端配置是否正确。