nacos-group/nacos-mcp-router

English | 简体中文
Overview
Nacos is an easy-to-use platform designed for dynamic service discovery and configuration and service management. It helps you to build cloud native applications and microservices platform easily.
This MCP(Model Context Protocol) Server provides tools to search, install, proxy other MCP servers, with advanced search capabilities including vector similarity search and multi-provider result aggregation.
Nacos-MCP-Router has two working modes:
Router mode: The default mode, which recommends, distributes, installs, and proxies the functions of other MCP Servers through the MCP Server, helping users more conveniently utilize MCP Server services.
Proxy mode: Specified by the environment variable MODE=proxy, it can convert SSE and stdio protocol MCP Servers into streamable HTTP protocol MCP Servers through simple configuration.
Search Features
Nacos-MCP-Router provides powerful search capabilities through multiple providers:
Search Providers
1. **Nacos Provider**
- Searches MCP servers using Nacos service discovery
- Supports keyword matching and vector similarity search
- Integrated with the local Nacos instance
2. **Compass Provider**
- Connects to a COMPASS API endpoint for enhanced search
- Supports semantic search and relevance scoring
- Configurable API endpoint (default: https://registry.mcphub.io)
Search Configuration
Configure search behavior using environment variables:
Search API
The search functionality is available through the MCP interface:
Results include:
- Server name and description
- Provider information
- Relevance score
- Additional metadata
Quick Start
Python
router mode
Tools
1. search_mcp_server
- Search MCP servers by task and keywords.
- Input:
- task_description(string): Task description
- key_words(string): Keywords of task
- Returns: list of MCP servers and instructions to complete the task.
2. add_mcp_server
- Add a MCP server. If the MCP server is a stdio server, this tool will install it and establish connection to it. If the MCP server is a sse server, this tool will establish connection to it
- Input:
- mcp_server_name(string): The name of MCP server.
- Returns: tool list of the MCP server and how to use these tools.
3. use_tool
- This tool helps LLM to use the tool of some MCP server. It will proxy requests to the target MCP server.
- Input:
- mcp_server_name(string): The target MCP server name that LLM wants to call.
- mcp_tool_name(string): The tool name of target MCP server that LLM wants to call.
- params(map): The parameters of the MCP tool.
- Returns: Result returned from the target MCP server.
Usage
Using uv (recommended)
When using uv no specific installation is needed. We will
use uvx to directly run *nacos-mcp-router*.
Using PIP
Alternatively you can install nacos-mcp-router via pip:
After installation, you can run it as a script using（As an example，Nacos is deployed in standalone mode on the local machine）:
Using Docker
Usage with Cline、Cursor、Claude and other applications
Add this to MCP settings of your application:
* Using uvx
> You may need to put the full path to the uvx executable in the command field. You can get this by running which uvx on MacOS/Linux or where uvx on Windows.