Unity MCP Pro Plugin

Unity MCP Pro插件

Unity编辑器插件，通过WebSocket将AI助手（Claude、Cursor、Windsurf、VS Code Copilot）连接到Unity编辑器。

50个类别的280多种工具 --场景管理、游戏对象、脚本、预制件、物理、照明、动画、材质、地形、粒子、音频、UI、构建管道、输入模拟、屏幕截图、测试、2D、时间线、样条曲线、ECS、网络代码、XR等。

特性

• 完全撤消/恢复 --每个AI操作都要通过Unity的撤销系统（Ctrl+Z）
• 生产级WebSocket --心跳、指数回退自动重新连接、端口扫描（6605–6609）
• 智能类型解析 --自动将字符串转换为Vector3、Color、Quaternion等。
• 域重新加载安全 --在不丢失连接状态的情况下重新编译脚本
• 服务器设置窗口 --内置编辑器窗口，用于配置MCP服务器和IDE集成
• 统一2021.3+ --支持Unity 2022、2023和Unity 6（内置、URP、HDRP）

50种工具类别

安装

选项1:Unity包管理器（Git URL）

1. 打开 Unity→ 窗口 → 包管理器
2. 点击 + → 从git URL添加包。。。
3. 输入：

   https://github.com/youichi-uda/unity-mcp-pro-plugin.git

选项2：克隆到您的项目

cd YourUnityProject/Packages
git clone https://github.com/youichi-uda/unity-mcp-pro-plugin.git com.unity-mcp-pro

选项3：下载并复制

下载此存储库并将其复制到项目的 Packages/com.unity-mcp-pro/ 目录。

设置

这个插件是 Unity侧组件 Unity MCP Pro。要将其与AI助手一起使用，您还需要MCP服务器。

1. 安装此插件 （见上文）
2. 获取MCP服务器 --可在 unity-mcp.aby.net
3. 构建MCP服务器:

   cd server && npm install && npm run build

1. 配置您的AI客户端 （或使用内置 窗口→ Unity MCP Pro→ 服务器安装程序):

   {
     "mcpServers": {
       "unity-mcp-pro": {
         "command": "node",
         "args": ["/path/to/server/build/index.js"]
       }
     }
   }

1. 打开 Unity --当编辑器启动时，插件会自动连接。检查 窗口→ Unity MCP Pro 查看连接状态。

建筑

AI Assistant  ←—stdio/MCP—→  Node.js MCP Server  ←—WebSocket—→  Unity Editor Plugin (this repo)

该插件在Unity编辑器中运行一个WebSocket客户端，该客户端连接到上的MCP服务器 127.0.0.1:6605–6609。所有工具调用都通过 CommandRouter 到域特定的命令处理程序。

多编辑器支持

在端口上同时运行多个Unity编辑器 6605-6609.设置 UNITY_MCP_PORT 环境变量以针对特定实例。

运行测试

1. 打开 Unity→ 窗口 → 将军 → 测试运行器
2. 选择 编辑模式 标签
3. 点击 全部运行

需求

• Unity 2021.3 LTS或更高版本
• Node.js 18+（用于MCP服务器）
• 任何兼容MCP的AI客户端

链接

• 网站
• Unity 资源商店 --统一人工智能桥（MCP Pro）
• MCP服务器（itch.io）
• Discord 的中文翻译是“不和谐”或“纷争”。

许可证

MIT许可证——见 许可证