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

让客户端动态发现服务

让客户端动态发现服务

本节把 MCP Client 从“写死某个 Server 地址”改成“只绑定逻辑服务,再由 Nacos 提供当前可用端点”。完成后,实例扩容、下线或重启时,客户端不需要修改地址配置,也能继续选择可用 MCP Server 发起调用。

学习目标

  • 区分 MCP 目录发现与运行时实例发现,知道动态变化发生在哪一层。
  • 配置 Spring AI Alibaba Nacos MCP Client 按服务名和版本发现远程 Server。
  • 用实例查询验证扩缩容后的地址变化,并避免在业务代码中缓存固定 IP。

动态发现替换的不是服务名

静态配置通常把 http://10.0.0.8:18001/sse 之类的地址直接写进客户端。一旦实例漂移、扩容或故障,配置就会过期。接入 Nacos 后,客户端仍需要知道要使用哪个逻辑 MCP Server,但不再把某个实例地址当成长期事实。

这里要区分两层发现:MCP 目录负责“这个 MCP Server 是谁、用哪个版本和协议”;服务发现负责“这个逻辑服务当前有哪些可用实例”。如果希望客户端根据自然语言任务在大量 MCP Server 中自动搜索,而不是预先指定服务名,应使用 MCP Router 一类的目录搜索能力。

对比项 静态地址 Nacos 动态发现
客户端保存 固定 URL/IP 服务名、版本与 Nacos 地址
扩容 手工补地址 新实例注册后进入发现结果
下线 容易继续命中过期地址 实例状态变化后从可用集合移除
配置职责 地址与业务绑定 逻辑身份与运行时地址分离

MCP 客户端动态发现与调用链路

配置按服务名发现 MCP Server

下面以远程 SSE 类型 MCP Server 为例。片段示例:它应放入 Spring Boot 客户端的 application.yml,并依赖 Spring AI Alibaba 的 Nacos MCP Registry Starter 与 Spring AI MCP Client;服务端需要已经把同名、同版本的 MCP Server 注册到 Nacos。

yaml
spring:
  ai:
    alibaba:
      mcp:
        nacos:
          server-addr: ${NACOS_SERVER_ADDR:127.0.0.1:8848}
          namespace: ${NACOS_NAMESPACE:public}
          username: ${NACOS_USERNAME:nacos}
          password: ${NACOS_PASSWORD:nacos}
          client:
            enabled: true
            sse:
              connections:
                weather:
                  service-name: weather-mcp-server
                  version: 1.0.0
    mcp:
      client:
        enabled: true
        name: dynamic-mcp-client
        version: 1.0.0
        initialized: true
        request-timeout: 30s
        type: sync
        toolcallback:
          enabled: true

这段配置只固定 weather-mcp-server 和 1.0.0 这一逻辑身份。实际 IP 与端口由注册信息解析,框架创建的负载均衡 MCP Client 或 ToolCallbackProvider 再基于当前端点建立连接。生产环境不要把示例中的默认用户名、密码直接带入配置文件,应改用环境变量或平台密钥注入。

从发现结果发起调用

片段示例:下面代码依赖已经完成的 Spring AI ChatClient 模型配置,并依赖前面的 Nacos MCP Client 配置。它不直接保存任何实例地址,而是把动态发现生成的 ToolCallbackProvider 交给 ChatClient;真正调用工具时,由负载均衡 MCP Client 选择当前端点。

java
@Bean
CommandLineRunner callDynamicMcp(
        ChatClient.Builder builder,
        @Qualifier("loadbalancedSyncMcpToolCallbacks") ToolCallbackProvider tools) {
    return args -> {
        ChatClient chatClient = builder
                .defaultToolCallbacks(tools.getToolCallbacks())
                .build();

        String answer = chatClient.prompt("调用天气工具查询杭州天气")
                .call()
                .content();
        System.out.println(answer);
    };
}

这里没有出现 <IP> 或 <PORT>,这正是动态发现的边界:业务代码只消费逻辑工具,端点解析与选择留在发现层。实际输出取决于模型、工具实现和实时数据,因此验证重点不是固定文本,而是服务扩缩容后无需修改客户端代码仍能成功完成工具调用。

验证实例地址会随扩缩容变化

为了只观察“服务发现”这一层,可以直接查询已知服务的实例列表。以下命令适合本地未启用鉴权的实验环境,并要求安装 jq;开启鉴权时应按当前 Nacos 部署的访问凭据规则补充认证信息。

bash
NACOS_ADDR="${NACOS_ADDR:-127.0.0.1:8848}"
MCP_SERVICE="${MCP_SERVICE:-weather-mcp-server}"

curl -sS "http://${NACOS_ADDR}/nacos/v3/client/ns/instance/list?namespaceId=public&serviceName=${MCP_SERVICE}"   | jq -r '.data[] | select(.healthy == true and .enabled == true) | "\(.ip):\(.port)"'

预期输出

text
<IP>:<PORT>
<IP>:<PORT>

实际地址和行数取决于当前健康实例数量。先启动一个 Server 执行一次,再扩容到两个实例后重复执行;结果应增加新端点。下线其中一个实例后再次查询,旧端点应在状态收敛后退出可用集合。

调用端不要重新缓存固定地址

动态发现生效后,业务代码应该面向框架提供的负载均衡 MCP Client 或 ToolCallbackProvider 调用,而不是先取一次 IP 再长期保存。否则虽然 Nacos 已经感知扩缩容,应用仍会被自己的本地缓存“锁死”在旧实例上。

扩缩容期间允许存在很短的收敛窗口:新实例刚注册时客户端可能尚未收到更新,下线实例也可能在连接关闭与订阅刷新之间短暂可见。验证时应关注“是否最终收敛并继续成功调用”,而不是要求所有观察点在同一毫秒完全一致。

单机开发、stdio 本地进程或所有流量都必须经过一个稳定网关时,固定入口依然合理。远程 MCP Server 一旦存在多副本、弹性扩缩容或故障迁移,客户端就更适合只固定逻辑服务身份,把运行时地址交给 Nacos 维护。这样实例变化只改变注册中心中的可用集合,不再变成每个客户端的配置变更。

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

目录与阅读设置

阅读设置

17

记录一个想法

让客户端动态发现服务

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

登录哪都通