服务注册与分布式协调 / 系统课时
部署 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])

启动 Router
下面使用官方 Python 包通过 uvx 启动 Streamable HTTP 模式。示例假设 Nacos 在本机 8848 端口,<PASSWORD> 需要替换为实际凭据;如果使用其他命名空间或端口,同样替换对应环境变量。
# 先替换实际密码,避免把生产凭据写进脚本或版本库
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预期结果
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> 应替换为你已经登记服务的名称或能力关键词。
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>"}}}'预期结果
第一个请求返回的工具列表包含 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 才能真正减少客户端耦合。