企业官网建设流程全解析

Unity MCP 接入手册：从装好 Bridge 到发出第一条指令

【免费下载链接】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

Unity MCP 把大语言模型接进 Unity 编辑器，让你用一句自然语言完成建对象、调场景、改脚本这类原本要逐格点鼠标的事。本文按"装好、连上、跑通第一条指令"的顺序走一遍，并附上排障清单与多项目建议。

先说清它是什么：两个组件，一条链路

Unity MCP 走的是 MCP（模型上下文协议，让大模型对接外部工具的标准协议）这条链路，本体拆成两半：

• Bridge：一个装在编辑器里的 Unity 包，负责接收指令、调用 Unity API 并把结果回传；
• Python 服务器：跑在本地的中间层，对接你的 MCP 客户端（Cursor、VS Code、Claude Code 这类）。

相当于给 AI 一双手去直接操作编辑器——你说话，它落键。两半都在，链路才通。

最小跑通路径：装、连、发第一条指令

环境自查：四个依赖都要在位

动手前确认四样东西的版本对得上，缺哪个补哪个：

在 Package Manager 里装好 Bridge

1. 打开Window > Package Manager。
2. 点左上角+，选Add package from git URL...。
3. 粘贴下面这行并等待导入完成：

https://gitcode.com/gh_mirrors/un/unity-mcp.git?path=/MCPForUnity

导入完，编辑器里会多出 Unity MCP 的入口菜单。

打开设置窗口，让客户端自动连上

进入Window > Unity MCP。这一步会列出你机器上检测到的 MCP 客户端，对着你要用的那个点Auto Configure，状态灯变绿（Connected）即成功。

服务器首次拉起时，弹出一个"重建成功"的对话框属于正常现象，点掉即可。

自动配置失败时手动补一条服务器地址

有的客户端不认自动配置。此时打开该客户端的 MCP 配置文件，手动补一条服务器条目即可，形如：

{ "mcpServers": { "unityMCP": { "url": "http://localhost:8080/mcp" } } }

地址指向本地端口，确保客户端能找到跑着的 Python 服务器。更完整的逐客户端说明见 安装文档。

发出第一条指令

连上之后，在客户端对话框里直接说人话。先给一条温和的试金石：

在场景中心创建一个半径 2 单位的红色球体，再加一盏强度 1.2 的黄色平行光。

场景里出现球体和光，说明整条链路已经通了。

能力展开：四类常用操作，各配一条能照抄的指令

装好之后，它能覆盖的日常操作大致归成四类。下表里每条指令都可以直接拷进客户端试。

下面挑两项最常被用到的展开一下。

场景与层级：先问再动

改结构之前，先让 AI 把现状读出来，能少踩很多"改错对象"的坑。

列出当前场景的完整层级结构，标出所有挂了 Rigidbody 的对象，但先不要改动任何东西。

确认清单无误后，再下指令做批量调整或另存场景。

脚本读写：改之前先让 AI 读一遍

脚本类操作建议固定一个顺序：读 → 改 → 再读核对。

读取 Player.cs 的全部内容，然后在 Update 里加一段 WASD 移动逻辑，改完把改动后的文件再读一遍给我看。

删除脚本这类不可逆操作，同样先确认路径再执行。

连接不上或行为不对时，按这个顺序查

出问题别急着重装，按下面顺序过一遍，多数情况能定位到具体哪一环：

1. 先看状态窗口：打开Window > Unity MCP，确认 Bridge 与 Server 是否都显示为已连接；有一边没亮，就是断在那一环。
2. 确认服务器进程在跑：终端里手动拉起一次，看 Python 服务器能否正常启动、有没有报错。
3. 查端口与防火墙：客户端走本地端口通信，若本机防火墙拦了该端口，客户端会连不上；放行对应端口再试。
4. 重启兜底：重启 Unity 或重启 MCP 客户端，让两边重新握手。

进阶：内存、防火墙与多项目隔离

• 内存：编辑器同时吃 AI 请求与场景重建时内存会涨，给编辑器预留足量的可用内存，大项目尤其明显。
• 网络与防火墙：本地通信一般不出网，但个别客户端与服务器之间的端口仍可能被安全软件拦截；连不通时优先放行本地端口。
• 多项目：同时开多个 Unity 项目时，给每个项目配一套独立的 MCP 服务器实例（各自端口、各自配置），避免两个项目抢同一条链路。相关路由细节可看 多实例路由说明，排障清单的完整版在 排障文档。

它适合放在哪类工作流里

• 快速原型：描述想要的效果，让它先搭出基础结构再手动精修。例："搭一个俯视角房间，放四堵墙和一扇门，相机用正交投影。"
• 重复任务自动化：批量重命名资源、统一调参这类活交给它。例："把 Assets/Textures 下所有贴图按前缀加 _T 重命名。"
• 团队协作：新人上手时让它解释现有脚本与场景结构；代码审查时让它先汇总改动点。例："列出 Assets/Scripts 下所有脚本，告诉我哪些引用了 Physics。"

收尾

Unity MCP 的接入路径很短：装 Bridge、连服务器、发第一句指令。跑通之后，把重复的摆物件、调参数、改脚本这类事逐步挪给自然语言指令，你会很快摸清它在你工作流里真正省时间的边界。

【免费下载链接】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