Unity Code MCP

与 Unity Code Pro 一样,Unity Code MCP 也通过我们的 Visual Studio Code 插件与 Unity 通信,帮助你开发 Unity 游戏。核心区别很简单:Unity Code Pro 面向人类开发者,而 Unity Code MCP 面向 AI 代理。

有了 Unity Code MCP,AI 代理可以以前所未有的速度迭代你的游戏代码。

为什么使用它

  • 基于 Rust 构建,轻量且高性能
  • 聚焦编码工作流,而不是通用 IDE 操作
  • 返回精简且相关的输出,降低 token 消耗
  • 支持代理迭代工作流:写代码 → 编译 → 修复 → 测试

核心工具

Unity Code MCP 暴露两个工具:

Asset Database Refresh

  • 触发 Unity 资源刷新与编译
  • 返回编译错误及刷新阶段的警告/日志
  • 处理 Unity 域重载(domain reload)场景

Asset Database Refresh

Test Execution

  • 运行 Unity 测试并返回详细结果
  • 为失败测试提供堆栈跟踪与日志
  • 支持 EditMode 与 PlayMode 测试

Test Execution

安装

前置要求

  • Unity 6.0+

第 1 步:安装必需的 Unity 包

安装 Visual Studio Code Editor for Unity

要让 Unity Code MCP 正常工作,请确保 Visual Studio Code Editor 包处于启用状态。启用方式是选择由该包提供的外部脚本编辑器。可在 Unity 中通过 PreferencesExternal ToolsExternal Script Editor 验证,显示类似 “Visual Studio Code Editor v1.0.12 enabled” 即可。

第 2 步:获取 MCP 二进制文件

Releases 下载 MCP 二进制文件。

目前仅提供 Windows 二进制文件。如需其他平台,请从源码构建。Windows x64 是唯一官方支持目标。

第 3 步:配置你的 AI 助手

command 字段请使用绝对路径。

Cursor / Trae

{
  "mcpServers": {
    "unity-code": {
      "command": "/path/to/unity_code_mcp",
      "env": {
        "UNITY_PROJECT_PATH": "${workspaceFolder}"
      }
    }
  }
}

VS Code MCP Extension

{
  "mcp.servers": {
    "unity-code": {
      "command": "/path/to/unity_code_mcp",
      "env": {
        "UNITY_PROJECT_PATH": "${workspaceFolder}"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "unity-code": {
      "command": "/path/to/unity_code_mcp"
    }
  }
}

UNITY_PROJECT_PATH 是兜底选项。

如果你的客户端支持 MCP roots,会自动优先使用工作区根目录。

如果客户端无法解析 ${workspaceFolder},请改用绝对路径。