[!IMPORTANT] Union 已弃用。请使用 Unity 官方 MCP 服务器。

Union ♾️ - Unity MCP 服务器

一个用于 Unity 的模型上下文协议 (MCP) 服务器

主要功能

• 🖼️ 多模态视觉：你的智能体可以看到你所看到的。它可以查看场景、通过任何摄像机观察、监视播放模式以及检查资产缩略图。

• 🔎 强大的搜索：超越项目面板，同时在层级结构和项目资产中进行搜索。

• ✔️ 卓越的代码分析：利用 Unity 自身的编译器进行代码分析，比智能体的 linter 更准确。

• ⏩ 快速启动：通过单个 mcp.json 配置文件，在几秒钟内即可运行。

• 🛠️ 可扩展：以最少的样板代码添加你自己的项目特定工具。

• 📅 始终保持最新：通过 官方 MCP C# SDK 保持与最新的 MCP 协议版本（目前为 2025-06-18）同步。

Related MCP server: Unity MCP Server

兼容性

设置

1. 安装 node.js

2. 配置 mcp.json

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@nurture-tech/unity-mcp-runner", "-unityPath", "<path to unity editor>", "-projectPath", "<path to unity project>"]
    }
  }
}

这将自动在你的 Unity 项目中安装 is.nurture.mcp 包。请随意将这些更改提交到源代码管理中。

关于工具

认识你的 Unity AI 工具箱。

已知问题

• 在 Windows 上通过 Cursor 启动时，Google External Dependency Manager (EDMU) 会导致 Unity 在启动时无限挂起。此问题正在调查中。

• test_active_scene 工具偶尔会失败，并显示错误消息 Maximum call stack size exceeded.

• search 工具偶尔会失败，并显示错误消息 Search index is not ready yet. Please try again later.

添加项目特定工具

Union 使用官方的 C# MCP SDK。

1. 创建一个静态类来存放你的工具。在该类上添加 [McpServerToolType] 注解。

2. 声明静态方法来实现每个工具。在每个方法上添加 [McpServerTool] 注解。

3. 参考 Services 目录获取示例。

4. 你可能需要退出 Unity 并重启你的智能体，以便它能识别新工具。

使用技巧

以下是充分利用 Union 的一些技巧：

• 🚀 通过智能体启动：始终通过 AI 智能体的 MCP 集成来启动 Unity。从 Hub 启动 Unity 将阻止 MCP 服务器连接。

• 📂 项目级设置：如果你的智能体支持，请在项目级设置中配置 MCP 服务器。这允许你在不同的 Unity 项目之间无缝切换。

• ⚙️ 命令行参数：你可以为高级场景（如在 CI/CD 流水线中以 -batchmode 或 -nographics 运行）向 Unity 传递额外参数。在 Unity 特定参数前添加 -- 分隔符：

  {
    "mcpServers": {
      "unity": {
        "command": "npx",
        "args": [
          "-y",
          "@nurture-tech/unity-mcp-runner"
          "-unityPath",
          "<path to unity editor>",
          "-projectPath",
          ".",
          "--",
          "-batchmode",
          "-nographics"
        ]
      }
    }
  }

• ⚠️ 重要：不要使用 -logFile 命令行参数。MCP 服务器依赖 Unity 的标准输出进行通信。

• 🖥️ 分屏以实现视觉功能：对于 screenshot 等工具，请确保 Unity 编辑器在屏幕上可见，否则它最终会截取前台窗口的画面。