Nacos MCP Router

nacos-mcp路由器：提供搜索、安装、代理等功能的mcp服务器。

 

English | 简体中文

概述

纳科斯 是一个易于使用的平台，专为动态服务发现、配置和服务管理而设计。它可以帮助您轻松构建云原生应用程序和微服务平台。

此MCP（模型上下文协议）服务器提供搜索、安装、代理其他MCP服务器的工具，具有高级搜索功能，包括向量相似性搜索和多提供商结果聚合。

Nacos MCP路由器有两种工作模式：

路由器模式：默认模式，通过MCP服务器推荐、分发、安装和代理其他MCP服务器的功能，帮助用户更方便地使用MCP服务器服务。

代理模式：由环境变量mode=Proxy指定，可以通过简单的配置将SSE和stdio协议MCP服务器转换为可流式传输的HTTP协议MCP服务器。

搜索功能

Nacos MCP Router通过多个提供商提供强大的搜索功能：

搜索提供程序

1. Nacos提供商

- 使用Nacos服务发现搜索MCP服务器 - 支持关键字匹配和向量相似度搜索 - 与本地Nacos实例集成

1. 指南针提供商

- 连接到COMPASS API端点以增强搜索 - 支持语义搜索和相关性评分 - 可配置的API端点（默认值：https://registry.mcphub.io)

搜索配置

使用环境变量配置搜索行为：

# YOUR COMPASS API endpoint (for Outer Provider called Compass Provider)
COMPASS_API_BASE=https://registry.mcphub.io

# Minimum similarity score for results (0.0 to 1.0)
SEARCH_MIN_SIMILARITY=0.5

# Maximum number of results to return
SEARCH_RESULT_LIMIT=10

搜索API

搜索功能可通过MCP界面使用：

// Search for MCP servers
const results = await searchMcpServer(
  "Find MCP servers for natural language processing",
  ["nlp", "language"]
);

结果包括：

• 服务器名称和描述
• 供应商信息
• 相关度分数
• 附加元数据

快速开始

python

路由模式

工具

1. search_mcp_server

- 按任务和关键字搜索MCP服务器。 - 输入： - task_description（string）：任务描述 - key_words（string）：任务关键字 - 返回：MCP服务器列表和完成任务的说明。

1. add_mcp_server

- 添加MCP服务器。如果MCP服务器是stdio服务器，此工具将安装它并建立与它的连接 - 输入： - mcp_server_name（string）：MCP服务器的名称。 - 返回：MCP服务器的工具列表以及如何使用这些工具。

1. use_tool

- 此工具帮助LLM使用某些MCP服务器的工具。它将把请求代理到目标MCP服务器。 - 输入： - mcp_server_name（string）：LLM要调用的目标MCP服务器名称。 - mcp_tool_name（string）：LLM要调用的目标MCP服务器的工具名称。 - params（图）：MCP工具的参数。 - 返回：从目标MCP服务器返回的结果。

用法

使用紫外线（推荐）

使用时 uv 不需要特定的安装。我们将 使用 uvx 直接运行 *nacos mcp路由器*.

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

使用PIP

或者，您可以安装 nacos-mcp-router 通过pip：

pip install nacos-mcp-router

安装后，您可以使用以下命令将其作为脚本运行（例如，Nacos以独立模式部署在本地计算机上）：

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/nacos-mcp-router:latest

与Cline、Cursor、Claude和其他应用程序一起使用

将此添加到应用程序的MCP设置中：

• 使用uvx

{
    "mcpServers":
    {
        "nacos-mcp-router":
        {
            "command": "uvx",
            "args":
            [
                "nacos-mcp-router@latest"
            ],
            "env":
            {
                "NACOS_ADDR": ", optional, default is 127.0.0.1:8848",
                "NACOS_USERNAME": ", optional, default is nacos",
                "NACOS_PASSWORD": ", required"
            }
        }
    }
}

您可能需要将完整路径放在 uvx 可执行于 command 现场。你可以通过跑步来获得这个 which uvx 在MacOS/Linux或 where uvx 在Windows上。

• 使用docker

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

代理模式

代理模式支持将SSE和stdio协议MCP服务器转换为可流式传输的HTTP协议MCP服务器。

用法

代理模式的使用与路由器模式相似，但参数略有不同。建议部署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/nacos-mcp-router:latest

环境变量设置

|参数|说明|默认值|必填|备注|\ |-----------|------------------------------------------------------------|---------------|----------|-----------------------------------------------------------------------------------------------|\ |NACOS_ADDR|NACOS服务器地址|127.0.0.1:8848|否| NACOS服务器的地址，例如192.168.1.1:8848。注：包括端口|\ |NACOS_USENAME|NACOS用户名|NACOS|No | NACOS用户名，例如NACOS。 |\ |NACOS_PASSWORD|NACOS密码|-|是| NACOS密码，例如NACOS。 | |COMPASS_API_BASE |用于增强搜索的COMPASS API端点|https://registry.mcphub.io|否|覆盖默认COMPASS API终结点| |SEARCH_MIN_相似度|最小相似度得分（0.0-1.0）|0.5|否|按最小相似度得分过滤搜索结果| |SEARCH_RESULT_LIMIT|返回的最大结果数|10|否|限制搜索结果数| |NACOS_NAMESPACE | NACOS命名空间| public | No | NACOS名称空间，例如public| |TRANSPORT_TYPE|传输协议类型|stdio|否|传输协议种类。选项：stdio、sse、streamable_http。 |\ |PROXIED_MCP_NAME|代理MCP服务器名称|-|否|在代理模式下，指定要转换的MCP服务器名称。必须先在Nacos注册。 |\ |MODE|工作模式|路由器|否|可用选项：路由器、代理。 | |PORT|TRANSPORT_TYPE为sse或流式传输时的服务端口_http|8000|否|| |ACCESS_KEY_ID|阿里云ram访问密钥ID|-|否|| |ACCESS_KEY_SECRET|阿里云ram访问密钥机密|-|否||

打字稿

与Cline、Cursor、Claude和其他应用程序一起使用

{
  "mcpServers": {
    "nacos-mcp-router": {
      "command": "npx",
      "args": [
        "nacos-mcp-router@latest"
      ],
      "env": {
        "NACOS_ADDR": ", optional, default is 127.0.0.1:8848",
        "NACOS_USERNAME": ", optional, default is nacos",
        "NACOS_PASSWORD": ", required"
      }
    }
  }
}

许可证

nacos-mcp路由器根据Apache 2.0许可证获得许可。这意味着您可以根据Apache 2.0许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅 LICENSE 项目存储库中的文件。