Unity MCP 快速配置指南：让 AI 接管 Unity 编辑器为你搭场景-创锋一号

Unity MCP 快速配置指南：让 AI 接管 Unity 编辑器为你搭场景

【免费下载链接】unity-mcpUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.项目地址: https://gitcode.com/GitHub_Trending/un/unity-mcp

你有没有想过让 AI 帮你写几段游戏代码，结果贴进 Unity 后，还得自己一个个去摆场景、导资源、跑测试？Unity MCP 就是来解决这个断点的：它在 AI 助手和 Unity 编辑器之间架了一座桥，你打一句话，AI 就能直接在编辑器里建对象、改 C# 脚本、管理项目资源，两个窗口来回切换的日子到此为止。

价值速览：凭什么值得把编辑器交给 AI

项目由两部分组成：一个用 Python 写的 MCP 服务器（Server/src/services/tools/）和一个装进 Unity 的 C# 编辑器插件（MCPForUnity/）。两者合力把 40 多个编辑器操作变成 AI 可调用的工具，覆盖场景、对象、脚本、材质、物理到测试。它 MIT 协议免费，且能对接 Claude Desktop、Cursor、VS Code、Windsurf、Cline 等十余种客户端，不绑定任何一家生态。你在编辑器里手动重复的活越多，它带来的节省就越明显。

环境预检：开工前只需确认三样东西

Unity 编辑器 2021.3 LTS 或更高版本（当前 6.x 系列均可用）。
Python 3.10+，以及uv包管理器——服务器靠它一键拉起，必须能被终端找到。
任意一款 MCP 客户端：Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 都可以。

如果你打算动服务器源码，可以先把整个仓库拉到本地：

git clone https://gitcode.com/gh_mirrors/un/unity-mcp

分步搭建：四步完成 AI 到 Unity 的接线

第一步：导入 Unity 插件，选最快的路子

在 Unity 里打开Window → Package Manager，点+选择 Add package from git URL，或者去 Asset Store 搜索导入。如果你习惯命令行，一行搞定：

openupm add com.coplaydev.unity-mcp

第二步：一键安装 uv，让服务器开箱即跑

uv负责拉取并运行 Python 服务器，macOS / Linux 一行命令装完：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows 用户可用 winget 安装。各平台的常见安装目录和排查方法，见 website/docs/guides/uv-setup.md。

第三步：打开管理窗口，用 Auto-Setup 跑完向导

在 Unity 里打开Window → MCP for Unity（快捷键 Ctrl/Cmd+Shift+M），点击 Auto-Setup，窗口会自动检测 Python 与uv、注册并构建服务器，全程基本不用你动手。开发场景下还能在 Advanced Settings 里把 Server Source Override 指向本地Server/目录。构建阶段界面如下：

第四步：一键配置已检测的 AI 客户端，启动桥接验证

回到窗口勾选你在用的客户端，点击 Configure All Detected Clients，它会替你写好客户端配置文件，无需手工编辑 JSON。再点 Start Bridge 启动桥接，状态面板变成 Connected 就算全部接通：

核心能力演示：三件让你想天天用的事 🎮

一句话搭场景。AI 会先查看当前场景，再逐个创建对象、赋材质。你说"在场景里创建红、蓝、黄三个立方体，沿 X 轴间隔 1 个单位"，几秒后 Hierarchy 里就多出三个方块，整条链路由manage_scene、manage_gameobject等核心工具完成。

AI 写脚本、改脚本，带校验落地。生成 C# 代码后，会先经过 Roslyn 语法与语义校验再写入工程，实现见 MCPForUnity/Editor/Tools/ManageScript.cs，校验机制可看 website/docs/guides/roslyn.md。

跑测试、管资产一句话的事。让它"跑一遍 EditMode 测试并列出失败项"，它自己执行并回报结果；批量处理资源则交给 MCPForUnity/Editor/Tools/ManageAsset.cs。整个过程你可以直接盯着看：

踩坑速修：两个最常见的连接问题 ⚠️

AI 提示"No Unity Instances Found"。多半是 http / stdio 传输模式切换后配置没生效：先重启客户端，再看状态面板是否 Connected，不行就在窗口里点 Restart Server。更多场景见 website/docs/guides/troubleshooting.md。

窗口显示 uv Not Found 或找不到 claude。macOS 上从 Finder 启动的 Unity 不会继承终端的 PATH，这很正常。用窗口里的 Choose UV Install Location（或 Choose Claude Location）手动指定可执行文件的绝对路径即可，配置会自动保存。

企业官网建设流程全解析