如何在 5ire 中使用远程 Server

可以使用 mcp-remote 来接入远程Server。

下面是一个示例

{
  "remote-example": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "https://remote.mcp.server/sse"
    ]
  }
}

下面是 5ire 中一个实际使用 mcp-remote 的示例。

自定义请求头

{
  "remote-example": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "https://remote.mcp.server/sse",
      "--header",
      "Authorization: Bearer ${AUTH_TOKEN}"
    ]
  },
  "env": {
    "AUTH_TOKEN": "..."
  }
}

调用工具时出现 “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)
  • 配置网络代理加速访问

在启用工具时出现 Error: MCP error :Connection closed

在启用时出现这个错误,常见原因有

  1. 配置错误,比如使用了错误的命令,或者没有正确配置环境变量。
  2. 运行环境不满足要求, 比如本机的 Python 版本是 3.10.x,但 Server 需要 Python 3.11 或更高版本。
  3. Server 本身实现问题,比如代码逻辑错误。

遇到这个问题,可以通过在命令行直接工具命令进行错误排查。

参考:

  1. Fail to start minimax mcp with 32000: Connection closed
  2. Error: MCP error -1: Connection closed