Nacos MCP Router手册

Nacos MCP Router是一个基于MCP官方SDK开发的标准MCP Server，为MCP Client提供MCP Server的智能搜索、安装、代理等功能， 极大地简化了MCP服务的使用流程。同时，Nacos MCP Router跟Nacos MCP Registry结合，可以实现MCP Server治理，如MCP Server及工具可见性、版本管理等。

MCP Router架构图

功能介绍

Nacos MCP Router 有两种工作模式：

router模式：默认模式，通过MCP Server推荐、安装及代理其他MCP Server的功能，帮助用户更方便的使用MCP Server服务。
proxy模式：使用环境变量MODE=proxy指定，通过简单配置可以把sse、stdio协议MCP Server转换为streamableHTTP协议MCP Server。

在router 模式下，Nacos MCP Router 作为一个标准MCP Server，提供MCP Server推荐、分发、安装及代理其他MCP Server的功能。其主要工具列表为

search_mcp_server
- 根据任务描述及关键字从MCP注册中心（Nacos）中搜索相关的MCP Server列表
- 输入:
  - task_description(string): 任务描述，示例：今天杭州天气如何
  - key_words(string): 任务关键字，示例：天气、杭州
- 输出: list of MCP servers and instructions to complete the task.
add_mcp_server
- 添加并初始化一个MCP Server，根据Nacos中的配置与该MCP Server建立连接，等待调用。
- 输入:
  - mcp_server_name(string): 需要添加的MCP Server名字
- 输出: MCP Server工具列表及使用方法
use_tool
- 代理其他MCP Server的工具
- 输入:
  - mcp_server_name(string): 被调的目标MCP Server名称.
  - mcp_tool_name(string): 被调的目标MCP Server的工具名称
  - params(map): 被调的目标MCP Server的工具的参数
- 输出: 被调的目标MCP Server的工具的输出结果

在proxy 模式下，Nacos MCP Router 仅提供代理功能，无需代码改动即可实现stdio、sse协议一键转换为streamableHTTP协议。

router模式

启动Nacos MCP Router

stdio协议

使用uvx

{
    "mcpServers":
    {
        "nacos-mcp-router":
        {
            "command": "uvx",
            "args":
            [
                "nacos-mcp-router@latest"
            ],
            "env":
            {
                "NACOS_ADDR": "<NACOS-ADDR>, 选填，默认为127.0.0.1:8848",
                "NACOS_USERNAME": "<NACOS-USERNAME>, 选填，默认为nacos",
                "NACOS_PASSWORD": "<NACOS-PASSWORD>, 必填"
            }
        }
    }
}

使用docker

{
    "mcpServers": {
        "nacos-mcp-router": {
        "command": "docker",
        "args": [
            "run", "-i", "--rm", "--network", "host",  "-e", "NACOS_ADDR=<NACOS-ADDR>", "-e",  "NACOS_USERNAME=<NACOS-USERNAME>", "-e", "NACOS_PASSWORD=<NACOS-PASSWORD>" ,"-e", "TRANSPORT_TYPE=stdio", "nacos-mcp-router:latest"
            ]
        }
    }
}

sse协议

uvx启动

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
export TRANSPORT_TYPE=sse
uvx nacos-mcp-router@latest

docker启动

docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=sse nacos-mcp-router:latest

streamableHTTP 协议

uvx启动

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
export TRANSPORT_TYPE=streamable_http
uvx nacos-mcp-router@latest

docker启动

docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=streamable_http nacos-mcp-router:latest

使用,Nacos-MCP-Router,以CherryStudio为例，MCP配置如下

stdio模式配置

{
        "mcpServers": {
            "nacos-mcp-router": {
            "command": "docker",
            "args": [
                "run", "-i", "--rm", "--network", "host",  "-e", "NACOS_ADDR=<NACOS-ADDR>", "-e",  "NACOS_USERNAME=<NACOS-USERNAME>", "-e", "NACOS_PASSWORD=<NACOS-PASSWORD>" ,"-e", "TRANSPORT_TYPE=stdio", "nacos-mcp-router:latest"
                ]
            }
        }
    }

sse模式配置

{
        "mcpServers": {
            "nacos-mcp-router": {
                "url": "http://$router_ip:8000/sse"
            }
        }
    }

streamableHTTP模式配置

 {
        "mcpServers": {
            "nacos-mcp-router": {
                "url": "http://$router_ip:8000/mcp"
            }
        }
    }

proxy模式

proxy模式诞生的初衷是帮助存量stdio、sse协议的MCP Server转换为streamableHTTP协议，享受streamableHTTP协议带来的好处。proxy模式下，Nacos MCP Router仅做请求透明转发，对外暴露目标MCP Server的工具列表。

proxy模式下，需设置环境变量MODE=proxy和PROXIED_MCP_NAME=

使用uvx

export NACOS_ADDR=$NACOS_ADDR
export NACOS_USERNAME=$NACOS_USERNAME
export NACOS_PASSWORD=$NACOS_PASSWORD
export TRANSPORT_TYPE=streamable_http
export MODE=proxy
export PROXIED_MCP_NAME=$PROXIED_MCP_NAME
uvx nacos-mcp-router@latest

使用docker

docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=streamable_http -e MODE=proxy -e PROXIED_MCP_NAME=$PROXIED_MCP_NAME  nacos-mcp-router:latest

环境变量配置


参数	描述	默认值	是否必填	备注
NACOS_ADDR	Nacos 服务器地址	127.0.0.1:8848	否	填写 Nacos 服务器的地址，如 192.168.1.1:8848，注意要写端口
NACOS_USERNAME	Nacos 用户名	nacos	否	填写 Nacos 用户名，如 nacos
NACOS_PASSWORD	Nacos 密码	密码	是	填写 Nacos 密码，如 nacos
NACOS_NAMESPACE	Nacos命名空间	public	否	Nacos命名空间，如 public
TRANSPORT_TYPE	传输协议类型	stdio	否	填写传输协议类型，可选值：stdio、sse、streamable_http
PROXIED_MCP_NAME	代理的 MCP 服务器名称	-	否	proxy模式下需要被转换的 MCP 服务器名称，需要先注册到Nacos
MODE	工作模式	router	否	可选的值：router、proxy
PORT	服务端口	8000	否	协议类型为sse或streamable时使用