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

部署 Nacos MCP Router

部署 Nacos MCP Router

这一节把 Nacos MCP Router 以 Router 模式启动起来,连接已有的 Nacos MCP Registry,并验证客户端既能看到 Router 自身工具,也能通过它读取目录中的 MCP Server,为 Agent 统一发现和调用工具建立入口。

学习目标

  • 启动连接内部 Nacos Registry 的 MCP Router,并暴露 Streamable HTTP 入口
  • 验证 Router 的工具列表与目录读取能力
  • 区分 Router、直连 MCP Server 与网关代理的职责边界

部署前检查

Router 本身不是服务目录的数据源,它依赖 Nacos MCP Registry 中已经登记的 MCP Server 元数据。因此先确认 Nacos 可访问、目标命名空间正确,并至少准备一个已注册且描述清晰的 MCP Server。Router 模式下常用的三个工具是 search_mcp_server、add_mcp_server 和 use_tool:先搜索,再初始化目标服务,最后代理具体工具调用。([GitHub][1])

Nacos MCP Router 与 Registry、Agent 和 MCP Server 的关系

启动 Router

下面使用官方 Python 包通过 uvx 启动 Streamable HTTP 模式。示例假设 Nacos 在本机 8848 端口,<PASSWORD> 需要替换为实际凭据;如果使用其他命名空间或端口,同样替换对应环境变量。

bash
# 先替换实际密码,避免把生产凭据写进脚本或版本库
export NACOS_ADDR='127.0.0.1:8848'
export NACOS_USERNAME='nacos'
export NACOS_PASSWORD='<PASSWORD>'
export NACOS_NAMESPACE='public'
export TRANSPORT_TYPE='streamable_http'
export PORT='8000'

# 默认 MODE=router;启动后保持前台运行
uvx nacos-mcp-router@latest

预期结果

text
Router 进程持续运行,并监听 Streamable HTTP 服务;启动日志中不应出现 Nacos 连接或认证失败。
具体日志文本会随版本变化。

Streamable HTTP 模式默认可通过 http://127.0.0.1:8000/mcp 作为 MCP 入口,端口由 PORT 控制。([GitHub][1])

验证入口与目录读取

另开一个终端,先调用标准 tools/list 检查 Router 自身工具,再用 search_mcp_server 验证它确实能访问 Registry。<KEYWORD> 应替换为你已经登记服务的名称或能力关键词。

bash
export ROUTER_URL='http://127.0.0.1:8000/mcp'

curl -sS "$ROUTER_URL" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

curl -sS "$ROUTER_URL" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_mcp_server","arguments":{"task_description":"验证 Router 能读取内部 MCP 服务目录","key_words":"<KEYWORD>"}}}'

预期结果

text
第一个请求返回的工具列表包含 search_mcp_server、add_mcp_server、use_tool。
第二个请求返回与 <KEYWORD> 匹配的候选 MCP Server;具体名称、数量和排序取决于当前 Registry 内容。

如果第一个请求成功而第二个请求失败,优先检查 NACOS_ADDR、账号密码和 NACOS_NAMESPACE;如果两者都失败,则先确认 Router 进程、端口和客户端访问路径是否正确。

划清职责边界

方式 更适合解决的问题 不应承担的职责
直连 MCP Server Agent 已明确知道唯一目标服务,追求最短调用链 动态目录搜索与多服务选择
Nacos MCP Router 根据目录发现候选、初始化目标 Server、统一代理工具调用 代替业务 MCP Server 实现具体工具能力
网关代理 统一入口、认证、限流、流量治理和跨网络暴露 仅靠流量转发完成语义化服务发现

Router 的价值在于把“先知道服务地址再调用”改成“先从目录发现能力,再建立连接并调用”。如果 Agent 永远只调用一个固定 MCP Server,直连通常更简单;如果需要从不断变化的内部工具目录中选择服务,Router 才能真正减少客户端耦合。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署 Nacos MCP Router

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

登录哪都通