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-mcpUnity MCP 把大语言模型接进 Unity 编辑器让你用一句自然语言完成建对象、调场景、改脚本这类原本要逐格点鼠标的事。本文按装好、连上、跑通第一条指令的顺序走一遍并附上排障清单与多项目建议。先说清它是什么两个组件一条链路Unity MCP 走的是 MCP模型上下文协议让大模型对接外部工具的标准协议这条链路本体拆成两半Bridge一个装在编辑器里的 Unity 包负责接收指令、调用 Unity API 并把结果回传Python 服务器跑在本地的中间层对接你的 MCP 客户端Cursor、VS Code、Claude Code 这类。相当于给 AI 一双手去直接操作编辑器——你说话它落键。两半都在链路才通。最小跑通路径装、连、发第一条指令环境自查四个依赖都要在位动手前确认四样东西的版本对得上缺哪个补哪个依赖版本要求作用Unity2020.3 LTS 及以上跑 Bridge 的编辑器宿主Python3.12 及以上跑本地服务器uv任意新版拉起 Python 依赖的包管理器Git任意新版从 git URL 拉取 Bridge 包在 Package Manager 里装好 Bridge打开Window Package Manager。点左上角选Add package from git URL...。粘贴下面这行并等待导入完成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 的黄色平行光。场景里出现球体和光说明整条链路已经通了。能力展开四类常用操作各配一条能照抄的指令装好之后它能覆盖的日常操作大致归成四类。下表里每条指令都可以直接拷进客户端试。能力它能做什么一条可照抄的指令自然语言控制编辑器建对象、灯光、着色器在场景中心创建一个半径 2 单位的红色球体并把它的材质换成红色场景管理加载 / 保存 / 创建场景、查层级列出当前场景的完整层级结构然后另存为 PrototypeScene资源操作导入、创建、修改、删除资源把 Assets/Models 里的 soldier.fbx 导入项目并统一把它的材质主色调调成灰C# 脚本编辑创建、读取、更新、删除脚本读取 Assets/Scripts/Player.cs给它加一个带 Rigidbody 的跳跃方法下面挑两项最常被用到的展开一下。场景与层级先问再动改结构之前先让 AI 把现状读出来能少踩很多改错对象的坑。列出当前场景的完整层级结构标出所有挂了 Rigidbody 的对象但先不要改动任何东西。确认清单无误后再下指令做批量调整或另存场景。脚本读写改之前先让 AI 读一遍脚本类操作建议固定一个顺序读 → 改 → 再读核对。读取 Player.cs 的全部内容然后在 Update 里加一段 WASD 移动逻辑改完把改动后的文件再读一遍给我看。删除脚本这类不可逆操作同样先确认路径再执行。连接不上或行为不对时按这个顺序查出问题别急着重装按下面顺序过一遍多数情况能定位到具体哪一环先看状态窗口打开Window Unity MCP确认 Bridge 与 Server 是否都显示为已连接有一边没亮就是断在那一环。确认服务器进程在跑终端里手动拉起一次看 Python 服务器能否正常启动、有没有报错。查端口与防火墙客户端走本地端口通信若本机防火墙拦了该端口客户端会连不上放行对应端口再试。重启兜底重启 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Unity MCP 接入手册：从装好 Bridge 到发出第一条指令
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-mcpUnity MCP 把大语言模型接进 Unity 编辑器让你用一句自然语言完成建对象、调场景、改脚本这类原本要逐格点鼠标的事。本文按装好、连上、跑通第一条指令的顺序走一遍并附上排障清单与多项目建议。先说清它是什么两个组件一条链路Unity MCP 走的是 MCP模型上下文协议让大模型对接外部工具的标准协议这条链路本体拆成两半Bridge一个装在编辑器里的 Unity 包负责接收指令、调用 Unity API 并把结果回传Python 服务器跑在本地的中间层对接你的 MCP 客户端Cursor、VS Code、Claude Code 这类。相当于给 AI 一双手去直接操作编辑器——你说话它落键。两半都在链路才通。最小跑通路径装、连、发第一条指令环境自查四个依赖都要在位动手前确认四样东西的版本对得上缺哪个补哪个依赖版本要求作用Unity2020.3 LTS 及以上跑 Bridge 的编辑器宿主Python3.12 及以上跑本地服务器uv任意新版拉起 Python 依赖的包管理器Git任意新版从 git URL 拉取 Bridge 包在 Package Manager 里装好 Bridge打开Window Package Manager。点左上角选Add package from git URL...。粘贴下面这行并等待导入完成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 的黄色平行光。场景里出现球体和光说明整条链路已经通了。能力展开四类常用操作各配一条能照抄的指令装好之后它能覆盖的日常操作大致归成四类。下表里每条指令都可以直接拷进客户端试。能力它能做什么一条可照抄的指令自然语言控制编辑器建对象、灯光、着色器在场景中心创建一个半径 2 单位的红色球体并把它的材质换成红色场景管理加载 / 保存 / 创建场景、查层级列出当前场景的完整层级结构然后另存为 PrototypeScene资源操作导入、创建、修改、删除资源把 Assets/Models 里的 soldier.fbx 导入项目并统一把它的材质主色调调成灰C# 脚本编辑创建、读取、更新、删除脚本读取 Assets/Scripts/Player.cs给它加一个带 Rigidbody 的跳跃方法下面挑两项最常被用到的展开一下。场景与层级先问再动改结构之前先让 AI 把现状读出来能少踩很多改错对象的坑。列出当前场景的完整层级结构标出所有挂了 Rigidbody 的对象但先不要改动任何东西。确认清单无误后再下指令做批量调整或另存场景。脚本读写改之前先让 AI 读一遍脚本类操作建议固定一个顺序读 → 改 → 再读核对。读取 Player.cs 的全部内容然后在 Update 里加一段 WASD 移动逻辑改完把改动后的文件再读一遍给我看。删除脚本这类不可逆操作同样先确认路径再执行。连接不上或行为不对时按这个顺序查出问题别急着重装按下面顺序过一遍多数情况能定位到具体哪一环先看状态窗口打开Window Unity MCP确认 Bridge 与 Server 是否都显示为已连接有一边没亮就是断在那一环。确认服务器进程在跑终端里手动拉起一次看 Python 服务器能否正常启动、有没有报错。查端口与防火墙客户端走本地端口通信若本机防火墙拦了该端口客户端会连不上放行对应端口再试。重启兜底重启 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考