1. 面试官为什么盯着 MCP 分布式部署不放如果你最近在面大模型应用岗简历上写了 MCP面试官大概率会顺着问一句单机跑个 MCP Server 谁都会生产环境多节点怎么注册、怎么发现、节点挂了客户端怎么感知这个问题卡住过不少人因为它考的不是「会不会写 MCP」而是「懂不懂企业级服务治理」。MCPModel Context Protocol本质是给大模型提供工具调用能力的协议层。单机模式下客户端在配置文件里写死一个 Server 地址就能用。但企业场景里你的 MCP Server 可能部署在 5 台机器上要负载均衡、要动态上下线、要灰度发布写死地址的做法直接失效。这时候就需要一个注册中心来管服务发现Nacos 是国内团队最常用的选择配合 Spring AI Alibaba 的 MCP Gateway可以把「Nacos 里注册的服务」自动转换成「MCP 协议可调用的 Server」客户端完全无感。这篇面向三类人正在准备大模型面试的开发者、要把 MCP 从 Demo 推向生产的后端工程师、以及想搞懂服务发现链路的架构同学。我会用 Nacos 3.0 Spring AI Alibaba MCP Gateway 搭一套多节点注册与路由同时把 TaoToken 统一 Key 接进 MCP 客户端的 settings.json让整条链路从服务发现到模型调用都能跑通。跟着做你能得到一个可复制的多节点 MCP 服务发现骨架。2. 前置准备Nacos、Spring AI Alibaba 与 TaoToken 统一 Key先把三块拼图摆清楚。Nacos 负责服务注册与健康检查MCP Gateway 负责协议转换与路由TaoToken 负责给 MCP 客户端提供统一的模型调用入口。三者关系是MCP Server 注册到 NacosGateway 从 Nacos 拉服务列表并暴露成 MCP 协议客户端通过 TaoToken 的 Key 调用模型模型再触发 MCP 工具。Nacos 这边建议用 3.0 及以上版本因为它内置了 MCP server registry 管理界面可以直接在控制台创建 MCP Server 和配置 tools省去手写注册逻辑。安装方式用官方单机模式即可默认端口 8848控制台地址是http://127.0.0.1:8848/nacos。Spring AI Alibaba 这边需要引入两个核心依赖spring-ai-alibaba-mcp-gateway负责网关代理spring-ai-alibaba-starter-nacos-mcp-server负责把服务注册到 Nacos。版本用1.0.0.3-SNAPSHOT注意这个版本号里有拼写实际以官方仓库为准。TaoToken 这块是给 MCP 客户端用的。它的作用是让你不用在每台机器上分别配置不同厂商的 Key而是用一个统一 Key 走所有模型调用。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要先去控制台创建一个 API Key后面写进 settings.json。注意Nacos 的 namespace 默认是 public如果你用了自定义 namespaceGateway 配置里的 namespace 要跟它一致否则拉不到服务列表。3. 可复制配置Nacos 注册 MCP Gateway 路由先建 MCP Server。登录 Nacos 控制台进入「MCP 列表管理」点新建填一个服务名比如echo-server然后在 tools 里加一个工具配置 request template。这个 template 的格式跟 Higress 兼容核心是把 MCP 调用参数映射成后端 HTTP 请求{ requestTemplate: { url: /v3/weather/weatherInfo?key{{ .config.credentials.api_key.data }}, argsToUrlParam: true, method: GET }, responseTemplate: { body: response value {{ .value }} } }这段配置的意思是当 MCP 客户端调用这个工具时Gateway 会把参数拼到 URL 上用 GET 请求后端服务然后把响应体按模板返回。{{ .config.credentials.api_key.data }}是从 Nacos 配置里读的凭证你可以把它换成自己的后端鉴权参数。接着在 Spring Boot 工程里引入依赖dependencies dependency groupIdorg.springframework/groupId artifactIdspring-web/artifactId /dependency dependency groupIdcom.alibaba.cloud.ai/groupId artifactIdspring-ai-alibaba-mcp-gateway/artifactId version1.0.0.3-SNAPSHOT/version /dependency dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-alibaba-starter-nacos-mcp-server/artifactId version1.0.0.3-SNAPSHOT/version /dependency /dependencies然后在application.yml里配 Nacos 和 Gatewayspring: ai: alibaba: mcp: nacos: server-addr: 127.0.0.1:8848 namespace: public username: nacos password: nacos gateway: service-names: - echo-serverservice-names里列的是你要暴露的 MCP Server 名称可以写多个。启动应用后Gateway 会去 Nacos 拉这些服务的实例列表对外暴露成 MCP 协议。如果你部署了多个 Gateway 节点它们都连同一个 Nacos客户端请求打到任意一个 Gateway 都能路由到后端 MCP Server负载均衡由 Nacos 的健康检查加 Gateway 内部策略完成。多节点注册的关键在于每个 MCP Server 实例启动时都会往 Nacos 注册自己的地址Gateway 不写死后端地址而是每次从 Nacos 拿最新列表。这样新增或下线一个 MCP Server不需要重启 Gateway。4. 验证请求多节点上下线与成功结果配置写完先验证服务发现链路。启动两个 MCP Server 实例端口分别用 8081 和 8082都注册到同一个 Nacos。然后在 Nacos 控制台的「服务列表」里应该能看到echo-server有两个实例。接着启动 Gateway观察日志里有没有拉取到服务列表。如果看到类似Loaded MCP servers: [echo-server]的输出说明注册发现通了。然后写一个 MCP 客户端调用测试。客户端这边用 TaoToken 统一 Key 接入settings.json 骨架如下{ mcpServers: { gateway: { url: http://127.0.0.1:8080/mcp, headers: { Authorization: Bearer YOUR_TAOTOKEN_API_KEY } } }, model: { provider: taotoken, apiKey: YOUR_TAOTOKEN_API_KEY, baseUrl: https://taotoken.net/api } }把YOUR_TAOTOKEN_API_KEY换成你在 TaoToken 控制台创建的 Key。这个配置的作用是MCP 客户端通过 Gateway 地址调用工具同时用 TaoToken 的 Key 调用模型。模型对话入口在 https://taotoken.net/api 你可以在控制台里查看调用记录。验证上下线动态感知把 8082 那个 MCP Server 停掉等 Nacos 健康检查标记为不健康再发一次请求Gateway 应该只路由到 8081。重新启动 8082等它注册上来请求又会分摊到两个节点。这个过程不需要重启 Gateway也不需要改客户端配置。成功结果长这样客户端调用工具返回response value {...}模型侧正常返回对话内容Nacos 控制台实例数随上下线变化。5. 本篇常见错排查第一个坑是 Nacos 版本不匹配。MCP server registry 是 Nacos 3.0 才有的功能如果你用 2.x控制台里根本找不到 MCP 列表管理入口。先确认版本再往下走。第二个坑是 namespace 写错。Gateway 配置里的 namespace 必须跟 MCP Server 注册时用的 namespace 一致默认都是 public。如果你在 Nacos 里建了自定义 namespace两边都要改否则 Gateway 拉不到服务日志里会显示服务列表为空。第三个坑是依赖版本冲突。spring-ai-alibaba-mcp-gateway和spring-ai-alibaba-starter-nacos-mcp-server的版本要一致混用不同版本会导致注册逻辑和网关逻辑对不上。另外注意1.0.0.3-SNAPSHOT这个版本号里的拼写以官方仓库实际发布的为准。第四个坑是 TaoToken Key 没配对。settings.json 里Authorization头的格式是Bearer加 Key中间有空格。baseUrl 用 https://taotoken.net/api 不要多加路径。如果调用返回 401先去控制台确认 Key 是否有效、额度是否充足。第五个坑是 Gateway 端口和 MCP Server 端口搞混。Gateway 自己占一个端口比如 8080MCP Server 占 8081、8082客户端连的是 Gateway 的地址不是 MCP Server 的地址。这个搞反了会一直连不上。6. 接入与排障的下一步如果你在配 Nacos 注册或 Gateway 路由时卡住先去 TaoToken 控制台把 API Key 建好再对照接入文档检查 settings.json 的字段。API Keys 管理入口在 https://taotoken.net/api-keys 接入文档在 https://taotoken.net/doc 里面有完整的字段说明和示例。想先验证模型调用是否通可以直接用模型对话页面发一条消息确认 Key 和 baseUrl 没问题再去调 MCP 工具。模型对话入口是 https://taotoken.net/chat 。如果你打算长期跑编码类 Agent 或者多节点 MCP 服务建议看一下 Coding Plan它更适合高频调用场景入口在 https://taotoken.net/coding-plan 。Claude Code 相关的接入配置在 https://taotoken.net/claude-code 。整条链路跑通后你会发现 MCP 分布式部署的核心不是写多少代码而是把服务注册、协议转换、统一鉴权这三件事拆清楚。Nacos 管注册发现Gateway 管协议路由TaoToken 管 Key 统一各司其职。面试时能把这套链路讲明白比背概念有用得多。