服务注册与分布式协调 / 系统课时

接入网关暴露 MCP 端点

接入网关暴露 MCP 端点

这一节把已经声明好的 MCP 服务真正接到访问入口:让网关从 Nacos AI Registry 获取服务与工具元数据,把客户端的 MCP 请求转换并路由到原有 API,同时用三段检查确认 Registry、网关和后端处于同一条可用链路上。

学习目标

  • 配置 Nacos Registry、兼容网关与后端 API 之间的职责和路由边界
  • 确定对外 MCP Endpoint,并用请求验证注册中心、网关和后端健康状态
  • 根据返回位置判断故障是在元数据发现、网关转换还是业务接口

先固定三层职责

接入前先把三个地址分开。Nacos AI Registry 保存 MCP Server、工具定义、版本和 Endpoint 等控制面信息;网关负责订阅这些信息并暴露 Remote MCP Endpoint;原有业务服务仍只处理自己的 HTTP API。客户端不应该直接拿后端 REST 地址当 MCP 地址,后端也不应该反向调用网关形成回环。

层 需要确认的值 通过标准
Nacos AI Registry <NACOS_HOST>、命名空间、MCP 服务名与已发布版本 服务和工具元数据可被网关读取
MCP 网关 对外域名、路由前缀、最终 <MCP_ENDPOINT> tools/list 能返回已发布工具
后端 API <BACKEND_HOST>:<PORT> 与健康检查路径 网关可达,业务实例健康

Registry、网关与后端的路由关系

配置对外路由

在兼容 Nacos MCP Registry 的网关中,把 Nacos 3.x 实例配置为服务来源,并让网关订阅目标命名空间。随后为目标 MCP Server 绑定对外域名与路由前缀,后端目标仍指向存量 API 服务。最终地址必须以网关给出的连接信息为准,不要凭经验自行拼接 /sse 或 /mcp。

对于“REST API 转 MCP”场景,工具定义描述的是客户端看到的参数与调用语义,请求模板描述如何生成后端 HTTP 请求;网关路由决定请求真正发往哪个上游。把这两层混为一谈,最常见的结果是工具能被发现但调用返回 404,或请求被错误地再次送回网关。

做三段健康检查

下面的命令分别检查 Nacos Server、后端健康接口和现代 Remote MCP Endpoint。Nacos 3.x 提供 /nacos/v3/admin/core/state/liveness 存活检查;现代 Higress MCP 数据面可直接处理 tools/list,并使用协议版本与方法请求头参与网关治理。([Nacos 官网][1]) 将占位符替换成实际值;如果网关只暴露旧版 SSE 连接,则应改用网关提供的 MCP 客户端连接方式,而不是直接套用最后一条 HTTP 请求。

bash
curl -i "http://<NACOS_HOST>:8848/nacos/v3/admin/core/state/liveness"
curl -i "http://<BACKEND_HOST>:<PORT>/<BACKEND_HEALTH_PATH>"
curl -i -X POST "https://<HOST>/<MCP_PATH>" -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/list' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

预期输出

text
HTTP/1.1 200
{"code":0,"message":"success","data":"ok"}

HTTP/1.1 200
<BACKEND_HEALTH_RESPONSE>

HTTP/2 200
<TOOLS_LIST_RESPONSE>

<BACKEND_HEALTH_RESPONSE> 取决于业务框架;<TOOLS_LIST_RESPONSE> 的具体字段会随协议版本和网关实现变化,但必须能看到目标服务的工具集合。状态码、协议版本或响应头在不同部署中可能不同,验收重点是三段请求分别成功且工具列表来自刚发布的 Registry 版本。

按失败位置定位问题

Nacos 存活检查失败时,先处理注册中心地址、端口和集群状态,不要继续调网关。Nacos 正常而 tools/list 找不到目标工具,优先核对命名空间、服务名、发布版本以及网关的 Nacos 服务来源。工具可见但调用后端报 404,通常说明请求模板路径或网关上游路由错误;返回 502、503 时则继续检查实例健康、DNS、网络策略和 TLS。

最终可用状态不是“控制台里看见一条记录”,而是客户端能够通过唯一的 <MCP_ENDPOINT> 发现工具,网关能够把请求送到预期后端,并且每一层都有独立的健康证据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入网关暴露 MCP 端点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通