nacos-mcp-router

2天前发布 12 0 0
收藏 0

Nacos 一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。Nacos提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。

收录时间：
2025-06-11
打开网站手机查看
nacos-mcp-routernacos-mcp-router
nacos-mcp-router打开网站

Nacos 一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。Nacos提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理

Nacos-MCP-Router是一个基于MCP官方标准SDK实现的的MCP Server。它提供了一组工具，提供MCP Server推荐、分发、安装及代理其他MCP Server的功能，帮助用户更方便的使用MCP Server服务。

Python版接入

Nacos-MCP-Router有两种工作模式：

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

router模式

Tools

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

使用

使用 uv

如果使用 uv 无须安装额外的依赖， 使用 use uvx 直接运行 nacos-mcp-router。

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
uvx nacos-mcp-router@latest
使用 PIP

此外，你也可以通过pip安装 nacos-mcp-router :

pip install nacos-mcp-router

安装完成后，使用如下命令运行（以Nacos本地standalone模式部署为例）:

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
python -m nacos_mcp_router
使用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=$TRANSPORT_TYPE nacos-mcp-router:latest
使用Cline、Cursor、Claude等

添加MCP Server配置如下:

使用 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>, 必填"
            }
        }
    }
}

如果启动失败，你需要把command字段里的uvx替换为命令的全路径。uvx命令全路径查找方法为：MacOS或Linux系统下使用which uvx，Windows系统使用where uvx。

使用 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"
      ]
    }
  }
}

proxy模式

proxy模式支持把sse、stdio协议MCP Server转换为streamableHTTP协议MCP Server。

使用

proxy模式的使用与router类似，参数略有不同，增加环境变量：MODE=proxy, PROXIED_MCP_NAME=$PROXIED_MCP_NAME, 建议使用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

开发

本地开发步骤如下:

  1. 克隆仓库；
  2. 修改代码；
  3. 在Cline等工具中测试功能:
{
  "mcpServers": {
    "nacos-mcp-router": {
      "command": "uv",
      "args": [
        "--directory","PATH-TO-PROJECT","run","nacos-mcp-router"
      ],
      "env": {
        "NACOS_ADDR": "<NACOS-ADDR>, 选填，默认为127.0.0.1:8848",
        "NACOS_USERNAME": "<NACOS-USERNAME>, 选填，默认为nacos",
        "NACOS_PASSWORD": "<NACOS-PASSWORD>, 必填"
      }
    }
  }
}

环境变量设置
参数 描述 默认值 是否必填 备注
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时使用

常见问题

Typescript接入

配置

在 MCP 客户端（如 Cursor、Cline 等）中添加如下配置：

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

数据统计

相关导航