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)场景

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

安装
前置要求
- Unity 6.0+
第 1 步:安装必需的 Unity 包
安装 Visual Studio Code Editor for Unity。
要让 Unity Code MCP 正常工作,请确保 Visual Studio Code Editor 包处于启用状态。启用方式是选择由该包提供的外部脚本编辑器。可在 Unity 中通过 Preferences → External Tools → External 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},请改用绝对路径。