MCP for Unity 提示 uv Not Founduvx 启动不了服务器怎么修【免费下载链接】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 for Unity 后MCP for Unity 窗口状态面板显示红色uv Not Found配文Make sure uv is installed! [CLICK]客户端Cursor、VS Code、Windsurf、Rider 等基于 uv 的客户端也启动不了服务器。原因是客户端配置里写的是command: uvx参数形如--from mcpforunityserver mcp-for-unity --transport stdio由客户端直接调用uvx拉起 Python 服务器mcp-for-unity只要uv没安装、不在 PATH 上或者 GUI 启动的 Unity 读不到终端里的 PATH服务器就起不来状态面板会一直停在 uv Not Found。官方针对这个场景有专门的 uv Python 安装/修复指南本文按该文档给出一条完整的修复路径先验证、再安装、装不上就手动指定路径最后验证状态面板回到Connected。先验证uv 到底装没装在终端运行两条命令python3 --version # should be 3.10 uv --version # should print a version like uv 0.x前置要求是Python 3.10和uv包管理器两者缺一不可。两条都正常输出 → 说明uv本身没问题跳到 手动指定 uv 路径。uv报错找不到命令 → 继续下面的安装步骤。只有uv正常但python3版本低于 3.10 → 先装 Python 3.10macOS 可用官方安装包或brew install python3.123.12 为最新 LTS3.10 也可以Windows 用 python.org 官方安装包。安装 uv按系统选择文档给出的安装方式。这些命令都会修改你本机的环境安装程序到用户目录或系统目录安装前确认你有对应权限。macOS / Linux / WSLcurl -LsSf https://astral.sh/uv/install.sh | sh # or Homebrew on macOS brew install uvWindows PowerShellpowershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex # or winget install --idastral-sh.uv -e装完回到终端重新跑一次uv --version能输出版本号才算装好。uv 装了但 Unity 找不到手动指定路径如果终端里uv --version正常但状态面板仍是 uv Not Found通常是 PATH 问题文档列了两类典型原因macOS 从 Finder / Hub 启动的 GUI 应用不会继承你的 shell 启动文件终端里的 PATH 和 Unity 看到的 PATH 可能不一样。文档明确说这种情况下通过 MCP 窗口设置 uv 路径是最简单的修法。Windows vs WSL只在 WSL 里装了uv的话Windows 原生的 Unity 看不到它。要么在 Windows 侧装一份uv要么用 MCP 窗口指向 Windows 的uv.exe。操作路径打开Window → MCP for Unity用Choose UV Install Location浏览到uv可执行文件保存后路径会被自动记录并重新配置。文档给出的常见安装位置供参考OSPathmacOS/opt/homebrew/bin/uv、/usr/local/bin/uv、~/.local/bin/uvLinux/usr/local/bin/uv、/usr/bin/uv、~/.local/bin/uvWindows%LOCALAPPDATA%/Programs/Python/Python3xx/Scripts/uv.exe手动选择的路径存在UnityMCP.UvPath里跨会话持久有效。Windows 特别注意固定 WinGet Links 的 uvx 路径在 troubleshooting 文档 的 FAQ 里有一条针对 Cursor / Windsurf / VS Code 的问题uv明明装着MCP 客户端还是启动不了服务器。原因是部分 Windows 机器上存在多个uv.exe自动配置有时会挑到一个不太稳定的路径导致每次重启都启动失败或自动重写配置。文档给出的修法是在 MCP for Unity 窗口用Choose UV Install Location固定到WinGet Links shim路径%LOCALAPPDATA%\Microsoft\WinGet\Links\uv.exe——这个路径在 uv 升级过程中保持稳定。修完环境后的重建Repair Python Envuv找到了之后如果服务器仍然异常例如 Python 升级过、依赖模块缺失MCP 窗口里的Repair Python Env按钮会做三件事删除服务器目录下的.venv和.python-version如果存在在 Unity MCP Server 的src目录里运行uv sync重建一个干净的环境适用于 Python 升级后或缺少模块的场景。注意这个动作会删掉现有的虚拟环境重建前确认你不需要保留其中内容。服务器安装位置需要手动操作时用到OSPathmacOS~/Library/Application Support/UnityMCP/UnityMcpServer/src或~/Library/AppSupport/UnityMCP/UnityMcpServer/srcsymlinkWindows%USERPROFILE%/AppData/Local/UnityMCP/UnityMcpServer/srcLinux~/.local/share/UnityMCP/UnityMcpServer/src文档同时给出了手动修复/运行的方式UnityMcpServer/src替换为上一表中对应系统的路径cd UnityMcpServer/src uv sync uv run server.py结果验证按顺序核对终端uv --version有输出且 MCP for Unity 窗口的 uv Not Found 红字消失状态面板显示Connected安装文档中写明一切就绪时状态面板读作Connected在 MCP 客户端里发一条最简单的验证指令例如安装文档给的 first promptCreate a red, blue, and yellow cube in the current scene.能操作场景即说明服务器已被uvx正常拉起。另外文档提醒如果你在http和stdio之间切换过传输方式客户端Claude Code、JetBrains Rider 等可能会混乱并报No Unity Instances found——重启客户端让它重新读取配置即可。限制与边界本路径只解决 uv Not Found / uvx 启动不了服务器。如果状态是Claude Not FoundClaude Code 的claudeCLI 没找到那是另一个问题对应文档的修法是 Choose Claude Location 指定claude二进制路径。WSL2 中只装 uv 对 Windows 原生 Unity 无效这条限制在 Windows 上尤其常见见上文手动指定 uv 路径一节。更细的窗口行为各客户端的 Auto Configure、Manual Setup可参考 MCPForUnity/README.md客户端选型与手动 JSON 配置见 选择 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），仅供参考 MCP for Unity 提示 uv Not Found：uvx 启动不了服务器怎么修？
MCP for Unity 提示 uv Not Founduvx 启动不了服务器怎么修【免费下载链接】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 for Unity 后MCP for Unity 窗口状态面板显示红色uv Not Found配文Make sure uv is installed! [CLICK]客户端Cursor、VS Code、Windsurf、Rider 等基于 uv 的客户端也启动不了服务器。原因是客户端配置里写的是command: uvx参数形如--from mcpforunityserver mcp-for-unity --transport stdio由客户端直接调用uvx拉起 Python 服务器mcp-for-unity只要uv没安装、不在 PATH 上或者 GUI 启动的 Unity 读不到终端里的 PATH服务器就起不来状态面板会一直停在 uv Not Found。官方针对这个场景有专门的 uv Python 安装/修复指南本文按该文档给出一条完整的修复路径先验证、再安装、装不上就手动指定路径最后验证状态面板回到Connected。先验证uv 到底装没装在终端运行两条命令python3 --version # should be 3.10 uv --version # should print a version like uv 0.x前置要求是Python 3.10和uv包管理器两者缺一不可。两条都正常输出 → 说明uv本身没问题跳到 手动指定 uv 路径。uv报错找不到命令 → 继续下面的安装步骤。只有uv正常但python3版本低于 3.10 → 先装 Python 3.10macOS 可用官方安装包或brew install python3.123.12 为最新 LTS3.10 也可以Windows 用 python.org 官方安装包。安装 uv按系统选择文档给出的安装方式。这些命令都会修改你本机的环境安装程序到用户目录或系统目录安装前确认你有对应权限。macOS / Linux / WSLcurl -LsSf https://astral.sh/uv/install.sh | sh # or Homebrew on macOS brew install uvWindows PowerShellpowershell -ExecutionPolicy ByPass -c irm https://astral.sh/uv/install.ps1 | iex # or winget install --idastral-sh.uv -e装完回到终端重新跑一次uv --version能输出版本号才算装好。uv 装了但 Unity 找不到手动指定路径如果终端里uv --version正常但状态面板仍是 uv Not Found通常是 PATH 问题文档列了两类典型原因macOS 从 Finder / Hub 启动的 GUI 应用不会继承你的 shell 启动文件终端里的 PATH 和 Unity 看到的 PATH 可能不一样。文档明确说这种情况下通过 MCP 窗口设置 uv 路径是最简单的修法。Windows vs WSL只在 WSL 里装了uv的话Windows 原生的 Unity 看不到它。要么在 Windows 侧装一份uv要么用 MCP 窗口指向 Windows 的uv.exe。操作路径打开Window → MCP for Unity用Choose UV Install Location浏览到uv可执行文件保存后路径会被自动记录并重新配置。文档给出的常见安装位置供参考OSPathmacOS/opt/homebrew/bin/uv、/usr/local/bin/uv、~/.local/bin/uvLinux/usr/local/bin/uv、/usr/bin/uv、~/.local/bin/uvWindows%LOCALAPPDATA%/Programs/Python/Python3xx/Scripts/uv.exe手动选择的路径存在UnityMCP.UvPath里跨会话持久有效。Windows 特别注意固定 WinGet Links 的 uvx 路径在 troubleshooting 文档 的 FAQ 里有一条针对 Cursor / Windsurf / VS Code 的问题uv明明装着MCP 客户端还是启动不了服务器。原因是部分 Windows 机器上存在多个uv.exe自动配置有时会挑到一个不太稳定的路径导致每次重启都启动失败或自动重写配置。文档给出的修法是在 MCP for Unity 窗口用Choose UV Install Location固定到WinGet Links shim路径%LOCALAPPDATA%\Microsoft\WinGet\Links\uv.exe——这个路径在 uv 升级过程中保持稳定。修完环境后的重建Repair Python Envuv找到了之后如果服务器仍然异常例如 Python 升级过、依赖模块缺失MCP 窗口里的Repair Python Env按钮会做三件事删除服务器目录下的.venv和.python-version如果存在在 Unity MCP Server 的src目录里运行uv sync重建一个干净的环境适用于 Python 升级后或缺少模块的场景。注意这个动作会删掉现有的虚拟环境重建前确认你不需要保留其中内容。服务器安装位置需要手动操作时用到OSPathmacOS~/Library/Application Support/UnityMCP/UnityMcpServer/src或~/Library/AppSupport/UnityMCP/UnityMcpServer/srcsymlinkWindows%USERPROFILE%/AppData/Local/UnityMCP/UnityMcpServer/srcLinux~/.local/share/UnityMCP/UnityMcpServer/src文档同时给出了手动修复/运行的方式UnityMcpServer/src替换为上一表中对应系统的路径cd UnityMcpServer/src uv sync uv run server.py结果验证按顺序核对终端uv --version有输出且 MCP for Unity 窗口的 uv Not Found 红字消失状态面板显示Connected安装文档中写明一切就绪时状态面板读作Connected在 MCP 客户端里发一条最简单的验证指令例如安装文档给的 first promptCreate a red, blue, and yellow cube in the current scene.能操作场景即说明服务器已被uvx正常拉起。另外文档提醒如果你在http和stdio之间切换过传输方式客户端Claude Code、JetBrains Rider 等可能会混乱并报No Unity Instances found——重启客户端让它重新读取配置即可。限制与边界本路径只解决 uv Not Found / uvx 启动不了服务器。如果状态是Claude Not FoundClaude Code 的claudeCLI 没找到那是另一个问题对应文档的修法是 Choose Claude Location 指定claude二进制路径。WSL2 中只装 uv 对 Windows 原生 Unity 无效这条限制在 Windows 上尤其常见见上文手动指定 uv 路径一节。更细的窗口行为各客户端的 Auto Configure、Manual Setup可参考 MCPForUnity/README.md客户端选型与手动 JSON 配置见 选择 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），仅供参考