常见问题解答

调用工具时出现 "Error: spawn uvx ENOENT" 错误的原因是什么？

该错误表示系统在尝试启动 uvx 子进程时找不到对应的可执行程序。通常有以下两种情况：

1. 未安装 uvx ：系统环境变量中未配置 uvx，或根本未安装该工具
2. 路径配置问题 ：uvx 虽已安装但未添加到系统 PATH 环境变量

验证方法： 在终端直接输入 uvx 回车

1. 若提示 "command not found" 表示未安装或路径未配置
2. 若显示其他错误表示已安装但可能存在版本问题

解决方案：

• 先确认是否已正确安装 uvx，若没有可参考uvx 安装指南进行安装
• 检查系统环境变量是否包含 uvx 的安装路径

为什么会出现 "Error: MCP error -2: Request timed out" 错误？

该错误在两种场景下可能出现：

启用工具时

当从网络获取服务器代码超时时触发此错误。通常可以通过以下方式解决：

• 增加环境变量 UV_HTTP_TIMEOUT 的值（默认5分钟）
• 切换DNS解析服务（如使用1.1.1.1或8.8.8.8）
• 配置网络代理加速访问

在对话中调用工具时

通常由于服务器调用的第三方网络服务长时间无响应导致。若排除第三方服务自身故障的可能，可尝试：

• 更换DNS解析服务（如使用1.1.1.1或8.8.8.8）
• 配置网络代理加速访问