AI导哈

Unity AI助手插件

Unity MCP Pro是一款连接AI助手与Unity编辑器的插件，通过WebSocket实现280多种工具的无缝集成，覆盖场景管理、脚本编辑、物理模拟等多个开发环节。

  • by youichi-uda
  • C#
  • 本地部署
  • 82 星标
  • 更新于
在 GitHub 查看 youichi-uda/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种工具类别

类别 # 类别 #
项目 7 动画 7
场景 6 动画扩展 5
游戏对象 11 UI（画布） 6
脚本 6 音频 5
编辑器 5 粒子 5
预制 6 导航 5
材质和着色器 6 地形 4
物理学 6 构建管道 5
照明 5 批量操作 6
分析和分析 10 包管理器 6
输入模拟 8 调试 5
运行时扩展 7 屏幕截图和可视化 4
测试和质量保证 6 2D工具 6
控制器 4 时间线 5
环境 6 样条曲线 5
优化 7 着色器图 5
摄影机/摄影机 6 视觉脚本 5
后处理 5 分析器 4
人工智能工具 4 基准 4
游戏系统 5 贯穿游戏 4
导入设置 5 监视/监视 3
多场景 4 撤消历史记录 3
场景视图相机 4 可寻址 5
自定义编辑器 4 本地化 4
索具 4 ECS/DOTS 4
网络代码 4 XR/VR 4

安装

选项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
  4. 配置您的AI客户端 （或使用内置 窗口→ Unity MCP Pro→ 服务器安装程序):
    {
  "mcpServers": {
    "unity-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}
  5. 打开 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客户端

链接

许可证

MIT许可证——见 许可证

相关 MCP