Unity MCP 集成

Unity MCP 集成

使 AI 代理能够控制 Unity 编辑器，实现项目自动化操作。

GitHub
Created Byquazaaiquazaai

快速入门

前置条件

  • Unity 2021.3 或更高版本
  • Node.js 18+（用于运行 MCP 服务器）

安装步骤

1. 安装 Unity 包

方法 A：通过 Package Manager

  1. 打开 Unity Package Manager (Window > Package Manager)。
  2. 点击 + 按钮，选择 Add package from git URL...。
  3. 输入仓库地址：https://github.com/quazaai/UnityMCPIntegration.git。
  4. 点击 Add。

方法 B：导入自定义包

  1. 下载此仓库或 unityPackage。
  2. 在 Unity 中，导航到 Assets > Import Package > Custom Package。
  3. 选择 UnityMCPIntegration.unitypackage 文件。

2. 设置 MCP 服务器

方法 A：直接运行服务器

  1. 进入 mcpServer 目录。
  2. 安装依赖：npm install。
  3. 启动服务器：node build/index.js。

方法 B：添加到 MCP 主机配置

编辑配置文件，添加以下内容：

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "node",
      "args": [
        "path-to-project>\\Library\\PackageCache\\com.quaza.unitymcp@d2b8f1260bca\\mcpServer\\mcpServer\\build\\index.js"
      ],
      "env": {
        "MCP_WEBSOCKET_PORT": "5010"
      }
    }
  }
}

使用

打开 Window > MCP Debug 查看连接状态和测试功能。