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

手工登记第一个 MCP Server

手工登记第一个 MCP Server

这一节把一个已经能够运行的 MCP Server 手工登记到 Nacos AI Registry。你会在控制台填写服务标识、协议与端点,再用管理接口反查目录对象,确认 Registry 中的记录确实指向预期的运行时服务。

学习目标

  • 在 Nacos 控制台手工创建一个可查询的 MCP Server 目录项。
  • 区分目录元数据与真正运行的 MCP Server 进程。
  • 通过管理接口核对名称、协议、启用状态与端点对应关系。

先确认 Registry 登记的是什么

手工登记不是“在 Nacos 里启动一个 MCP Server”,而是把可发现信息写进目录。Nacos AI Registry 可以管理 MCP Server 的元数据、工具、资源、端点和版本;Agent、MCP Client 或 Router 再根据这些信息发现并连接真正的运行时服务。([Nacos 官网][1])

本节用一个已经运行的 weather-mcp 作为例子。为了让端点关系直观,选择远程 streamable 协议;如果你的服务使用 stdio,Nacos 保存的是本地启动配置而不是远程端点,字段结构会不同。([Nacos 官网][2])

在控制台创建目录项

  1. 进入 AI Registry → MCP Registry,先确认当前命名空间,例如 public。
  2. 打开创建 MCP Server 的入口,把名称填写为 weather-mcp,版本填写为 1.0.0,描述写成“提供天气查询能力”。
  3. 协议选择与真实服务一致的 streamable;没有网关做协议转换时,前端暴露协议也保持一致。
  4. 端点选择直接地址模式,填写真实 MCP Server 所在的 <HOST> 与 <PORT>,并保持服务启用后保存。

Nacos 控制台创建 MCP Server 的字段位置

反查保存后的目录对象

目录对象至少要能回答三个问题:它是谁、怎么连、是否可用。name 与版本负责身份,protocol/frontProtocol 描述连接方式,远程服务还会带端点信息;enabled 则表示目录中的启用状态。Nacos 3.x 的 MCP 管理接口可以按名称查询这些字段。([Nacos 官网][3])

下面使用 Admin API 做一次只读核对。<TOKEN> 代表有对应命名空间读取权限的访问令牌;<HOST>、<PORT> 以你的 Nacos Server 地址为准。

bash
curl -sS 'http://<HOST>:<PORT>/nacos/v3/admin/ai/mcp?namespaceId=public&mcpName=weather-mcp' -H 'Authorization: Bearer <TOKEN>' | jq '{code, name: .data.name, protocol: .data.protocol, enabled: .data.enabled}'

预期输出

json
{
  "code": 0,
  "name": "weather-mcp",
  "protocol": "streamable",
  "enabled": true
}

默认 Nacos 鉴权可先用用户名和密码登录获取 accessToken,再通过 Authorization: Bearer <TOKEN> 调用管理接口;不同鉴权插件的取令牌方式可能不同。([Nacos 官网][4])

用运行时事实做最终验收

Registry 中“有记录”只证明目录对象存在,不证明目标进程真的能提供 MCP 能力。验收时再检查真实 <HOST>:<PORT> 上的 MCP Server 已启动,并确认它使用的协议与目录项一致。若查询结果正确但客户端连接失败,优先回到运行时服务、网络可达性和协议匹配处排查,而不是重复创建同名目录项。

当控制台中的名称、协议、端点与实际进程一一对应,并且管理接口能稳定查到该对象时,第一个 MCP Server 就已经从“运行中的服务”变成了“可被 Registry 发现的目录条目”。

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

目录与阅读设置

阅读设置

17

记录一个想法

手工登记第一个 MCP Server

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

登录哪都通