Nacos Mcp Router

Name: Nacos Mcp Router
Author: nacos-group

@nacos-group

Repository

About Nacos Mcp Router

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

执行任务前首先使用本工具。根据任务描述及关键字搜索mcp server, 制定完成任务的步骤。注意：任务描述及关键字需要同时包含中文和英文。

安装指定的mcp server

使用某个MCP Server的工具

Overview

What is Nacos Mcp Router?

Nacos Mcp Router is a Model Context Protocol (MCP) server that provides functionality to search, install, and proxy other MCP servers. It integrates with Nacos for dynamic service discovery and configuration, supporting advanced search capabilities including vector similarity search and multi-provider result aggregation. The server offers two working modes: Router mode (default) for recommending and proxying MCP servers, and Proxy mode for converting SSE and stdio protocol MCP servers into streamable HTTP protocol MCP servers.

How to use Nacos Mcp Router?

You can run Nacos Mcp Router using uvx, pip, docker, or npx. Required environment variables include NACOS_PASSWORD; optional ones include NACOS_ADDR, NACOS_USERNAME, and COMPASS_API_BASE. After configuring environment variables, add it to your MCP client settings (e.g., Cline, Cursor, Claude) as shown in the README. For proxy mode, set MODE=proxy and specify PROXIED_MCP_NAME.

Key features of Nacos Mcp Router

Search MCP servers using Nacos and Compass providers
Install and connect to stdio or SSE MCP servers
Proxy tool calls to target MCP servers
Two modes: router (default) and proxy (protocol conversion)
Vector similarity search and multi-provider result aggregation
Configurable search similarity threshold and result limit

Use cases of Nacos Mcp Router

Discovering and installing MCP servers for AI assistants
Converting SSE or stdio MCP servers to streamable HTTP
Aggregating MCP server search results from multiple sources
Managing MCP server lifecycle in a microservices environment

FAQ from Nacos Mcp Router

What is the default working mode?

The default working mode is Router mode, which recommends, distributes, installs, and proxies other MCP Servers.

What environment variables are required?

NACOS_PASSWORD is required. NACOS_ADDR (default 127.0.0.1:8848) and NACOS_USERNAME (default nacos) are optional.

Can I use Nacos Mcp Router with Cursor or Claude?

Yes, you can add it to the MCP settings of applications like Cline, Cursor, and Claude using uvx, docker, or npx commands as described in the README.

How do I switch to proxy mode?

Set the environment variable MODE=proxy and specify PROXIED_MCP_NAME (the MCP server name registered in Nacos). Docker deployment is recommended for proxy mode.