跳到主要内容

如何添加自定义 MCP 服务器?

通过模型上下文协议(MCP),AI 模型可以访问外部工具和数据源,从而实现更强大的功能。ConsoleX AI 提供对基于 MCP 工具的全面支持,包括支持基于 SSE 和基于 Stdio 的 MCP 服务器。

在 ConsoleX 中集成和使用 MCP 服务器

在 ConsoleX AI 中添加和使用 MCP 服务非常简单,只需按照以下步骤操作:

  1. 登录 ConsoleX AI,点击左下角的 工具库(Tools Vault) 入口。
  2. 点击页面顶部的 添加 MCP 服务器(Add a MCP server) 按钮。
  3. 填写 MCP 服务器的 JSON 描述信息。
  4. 点击 保存(Save) 按钮,完成 MCP 服务器的集成。

MCP 自定义

如何配置基于 SSE 的 MCP 服务器

在 ConsoleX AI 中配置并添加基于 SSE 的 MCP 服务器非常简单,只需输入以下格式的配置:

{ 
"url": "<your_sse_mcp_server_endpoint>"
}

您还可以添加其他参数,这些参数将通过头部属性传递到服务器。例如,可以添加头部身份验证或传递其他配置参数:

{ 
"url": "<your_sse_mcp_server_endpoint>",
"Authorization": "Bearer <your_auth_token>",
"timezone": "Europe/Berlin"
}

注意: SSE 服务器需要自行从头部提取参数用于认证或功能逻辑处理。

如何配置基于 Stdio 的 MCP 服务器

ConsoleX 是一项云服务,因此无法直接通过 Stdio 调用本地资源。但您可以使用 MCP-connect 来实现中继,并启用基于 Stdio 传输协议的 MCP 服务器调用。

具体步骤如下:

  1. 在您的本地计算机上安装并运行 mcp-connect,并为安全性设置 auth_token
  2. 通过隧道服务(如 ngrok 或 Cloudflare Zero Trust)使您的 MCP 代理 URL 可通过公共网络访问。
  3. 在 ConsoleX 的 设置(Settings) 中输入全局 MCP 代理 URL 和 auth_token
  4. 之后,您可以像使用本地 MCP 客户端一样在 ConsoleX 中添加基于 Stdio 的 MCP 服务器配置。

个别配置:

除了设置全局代理终端和 auth_token,您还可以为每个 MCP 服务器单独设置 bridge_urlauth_token。个别设置将覆盖全局配置。

例如:

{
"bridge_url": "<your_mcp_bridge_url>",
"auth_token": "<your_auth_token>",
"command": "uvx",
"args": ["mcp-server-fetch"]
}

常见问题解答

问:哪些模型支持 MCP 服务器?

答:MCP 协议由 Anthropic 发起,因此 Claude 的 Sonnet 和 Opus 模型系列可以更好地支持 MCP 服务器调用。不过,MCP 服务器的工具部分对支持工具调用的任何其他大模型同样适用。

问:在 ConsoleX 中使用 MCP 服务器有哪些限制?

答:您无法直接在 ConsoleX 中添加基于 Stdio 的 MCP 服务器,但可以通过 MCP Bridge 实现基于 Stdio 传输协议的 MCP 调用。

问:无法成功添加本地基于 Stdio 的 MCP 服务器时,我该怎么办?

答:

  1. 首先,请确保 mcp-connect 已成功安装并运行。
  2. 确认 mcp-connect 终端能够通过公共网络访问(可以通过健康检查终端验证)。
  3. 如果终端可访问但仍有问题,请检查在终端中运行的 mcp-connect 的输出日志,以找到问题原因。