NM

Nacos MCP Router

Created 6 months ago

A MCP server that provides functionalities such as search, installation, proxy, and more.

development documentation public

What is Nacos MCP Router?

This MCP(Model Context Protocol) Server provides tools to search, install, proxy other MCP servers.

Documentation

nacos-mcp-router

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.

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:

COMPASS_API_BASE=https://registry.mcphub.io\n\n# Minimum similarity score for results (0.0 to 1.0)
SEARCH_MIN_SIMILARITY=0.5\n\n# Maximum number of results to return
SEARCH_RESULT_LIMIT=10

Search API

The search functionality is available through the MCP interface:

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

Quick Start# Python\n\n#### router mode Tools

  1. search_mcp_server - Search MCP servers by task and keywords.
  2. add_mcp_server - Add a MCP server.
  3. use_tool - This tool helps LLM to use the tool of some MCP server.
Usage# Using uv (recommended)
export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
uvx nacos-mcp-router@latest
```\n\n###### Using PIP
```bash
pip install nacos-mcp-router
```\n\n###### Using Docker
```bash
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

License

nacos-mcp-router is licensed under the Apache 2.0 License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the Apache 2.0 License.

Server Config

{
  "mcpServers": {
    "nacos-mcp-router-server": {
      "command": "npx",
      "args": [
        "nacos-mcp-router"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: Nacos Group
Category: community
License: Apache 2.0 License
Tags:
development documentation public