Unity MCP Package

Unity MCP Package

一个专注于增强材质编辑的 Unity 包，在原有 MCP 功能的基础上进行扩展。目前仅实现了材质增强功能，但项目仍在积极开发中，并会频繁更新。即将推出的功能包括灯光效果、高级材质属性、物理集成、地形增强等。此软件包通过 Model Context Protocol（MCP），实现 Unity 与大语言模型（LLM）之间的无缝通信，充当桥梁，让 Unity 能够向符合 MCP 规范的工具发送命令并接收响应。

概述

Unity MCP 服务通过 C# 在 Unity 与 Python 服务之间提供双向通信通道，让你能够：

• 资源管理：以编程方式创建、导入和操作 Unity 资源。
• 场景控制：管理场景、对象及其属性。
• 增强材质编辑：借助改进的灯光和着色器支持，应用和修改材质。
• 脚本集成：在 Unity 中创建、查看和更新 C# 脚本。
• 编辑器自动化：控制 Unity Editor 的撤销、重做、播放模式和构建流程等功能。
• 其他 Unity 功能：利用高级灯光控制和后期处理效果等新的实验性功能。

此项目非常适合希望借助大模型增强 Unity 项目或自动执行重复任务的开发者。

安装

使用 Unity MCP Package 前，请确保已安装以下内容：

• Unity 2020.3 LTS 或更高版本（⚠️ 目前仅适用于 URP 项目）
• Python 3.12 或更高版本
• uv 包管理器

第 1 步：安装 Python

从 python.org 下载并安装 Python 3.12 或更高版本。安装时，请确保将 Python 添加到系统 PATH。

第 2 步：安装 uv

uv 是一款 Python 包管理器，可简化依赖项管理。根据你的操作系统，使用以下命令安装：

• Mac：

  brew install uv
  

• Windows：

  powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  

  然后，将 uv 添加到 PATH：

  set Path=%USERPROFILE%\.local\bin;%Path%
  

• Linux：

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

如需其他安装方式，请参阅 uv 安装指南。

重要：未安装 uv 前请勿继续。

第 3 步：安装 Unity Package

1. 打开 Unity，然后前往 Window > Package Manager。
2. 点击 + 按钮，然后选择 Add package from git URL。
3. 输入：https://github.com/HuangChILun/reavorse-mcp.git

安装完成后，Unity MCP Package 将在你的 Unity 项目中可用。与 Claude Desktop 或 Cursor 等 MCP 客户端配合使用时，服务将自动启动。

功能

• 双向通信：在 Unity 与大模型之间无缝收发数据。
• 资源管理：导入资源、实例化预制件，并以编程方式创建新预制件。
• 场景控制：打开、保存和修改场景，还能创建和操作游戏对象。
• 增强材质编辑与灯光：改进材质属性控制、高级灯光、着色器集成和后期处理效果。
• 脚本集成：在 Unity 中创建、查看和更新 C# 脚本。
• 编辑器自动化：自动执行 Unity Editor 任务，例如构建项目或进入播放模式。
• 实验性功能：其他 Unity 功能仍在测试中，欢迎反馈意见。

故障排除

遇到问题？试试以下解决方法：

• Unity Bridge 未运行
  确保 Unity Editor 已打开且 MCP 窗口处于活动状态。必要时重启 Unity。

• Python 服务未连接
  确认 Python 和 uv 已正确安装，并且 Unity MCP 包已正确设置。

• Claude Desktop 或 Cursor 的配置问题
  确保 MCP 客户端已配置为与 Unity MCP 服务通信。

• 连接卡住或没有进展 在某些特殊情况下，如果进程似乎卡住且没有进展，请尝试关闭 Claude 和 Unity 项目，然后重新连接以重新建立连接。

联系方式

对项目有疑问？欢迎联系我们！

• X：@reavorse

致谢

原作者：非常感谢 justinpbarnett 创建了原始 Unity MCP 包。此增强版本以他的作品为基础。

特别感谢 Unity Technologies 提供出色的 Editor API，也感谢社区持续提供反馈。