Unity MCP 连接问题排查与性能调优从连不上到跑得顺【免费下载链接】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 是 AI 助手与 Unity 编辑器之间的桥MCP 即 Model Context Protocol让大模型获得操作工具的一套协议装好后 AI 就能管理资源、改场景、写脚本。本文聚焦 Unity MCP 配置中最头疼的两件事连不上怎么排、连上了怎么调得更快。连不上先按这个思路排查连接失败九成是端口问题但别上来就换端口——按看端口 → 验配置 → 查日志三步走大部分情况第一步就定位了。看端口打开 Unity 编辑器菜单里的 MCP For Unity 窗口连接区显示的端口号就是当前值。再执行一条命令确认谁占了它netstat -ano | findstr 6400macOS/Linux 用lsof -i :6400。是 Unity 自己的进程占着多半是上次域重载后旧监听器没放掉等几秒重连即可代码里专门留了 3 秒窗口处理这种自己撞自己的情况。是别的程序占着走下一节的手动换端口。验配置确认连接已建立、传输方式选对了。HTTP 传输下高级设置区的自动启动没勾的话编辑器打开后服务器不会自己跑状态会一直是断开。查日志打开 Unity 控制台的 MCP 输出重点找in use、timeout、reload这类字样。要更多细节在高级设置区勾选 Show Debug Logs日志量会明显变大。三处都正常还是连不上把编辑器完整重启一次再测。端口一次讲透默认值、自动换端口与手动固定默认端口是 6400被占会自动顺延最多试 100 个。这套逻辑在 PortManager.cs 里首选 6400可用就直接用被占则从 6401 开始逐个探测IsPortAvailable做一次真实试绑定找到即用并写进用户目录下的~/.unity-mcp/里按项目记着每个项目独立记忆端口多项目并行不会互相踩端口。手动固定端口的操作步骤打开 MCP For Unity 编辑窗口的连接区在 Unity 端口输入框里填你想要的端口号建议 1024–65535失焦即生效——若端口被占会弹 Port Unavailable 并回滚到当前值不占用就写入并持久化用连接区的测试连接按钮确认通了。配置参数调优清单性能参数集中在 Python 端改环境变量就行不用动代码。服务器配置类ServerConfig定义在 Server/src/core/config.py常用旋钮UNITY_MCP_CONNECTION_TIMEOUT单条命令的接收超时默认 300 秒。大批量导入、跑测试被掐断就调大它UNITY_MCP_COMMAND_TOTAL_TIMEOUT含重试在内的总时限默认 600 秒务必大于上一条日志级别默认 INFO排查时再临时调高平时别开 DEBUG——日志是 I/O 大户常开白拖慢响应。环境与资源同样值得整理关掉其他监听 6400–6500 区间的常驻服务减少撞端口概率临时开了日志记录会把每次工具执行写进Assets/UnityMCP/Log/mcp.log用完就关日志膨胀会拖慢编辑器编辑器与服务器同机跑时给 Unity 让出内存比任何参数都有效。高阶玩法按场景定制服务器行为高级设置区就是手动配置面板常见定制需求都在这里。换传输方式连接区下拉里可切 stdio、HTTP Local、HTTP Remote。stdio 是客户端直接拉起进程最省心HTTP 适合需要多客户端或远程接入的场景配自动启动后编辑器一开服务器就跟上改服务器源高级设置区的 Server Source Override 指向本地Server目录含 pyproject.toml想试自改的服务器代码时用脚本校验等级Basic 到 Strict 四档决定 AI 改代码后的检查深度——追求响应快选 Basic质量优先选 Comprehensive。原则只动你需要的项改完点测试连接确认健康状态变绿。排查速查表现象先看处理提示端口被占lsof -i :6400手动换端口或杀掉占位进程连上后频繁掉线调试日志里的 timeout调大UNITY_MCP_CONNECTION_TIMEOUT状态一直断开高级设置区的自动启动勾选后重开编辑器响应变慢日志级别与记录开关关掉 DEBUG 和日志记录多项目端口串台~/.unity-mcp/记录文件删掉对应项目的端口文件重探配置改完没生效传输方式与测试连接重连并确认健康状态从端口查起端口 → 配置 → 日志多数 Unity MCP 连接问题在前两步就有答案 【免费下载链接】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），仅供参考
