Nacos MCP Router

Nacos MCP Router

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

167
Stars
28
Forks
9
Releases

Overview

Nacos-MCP-Router is an MCP (Model Context Protocol) server that offers tools to search, install, and proxy other MCP servers, featuring advanced search capabilities such as vector similarity search and multi-provider result aggregation. It operates in two modes: Router mode (the default) and Proxy mode (enabled by setting MODE=proxy). In Router mode, it can recommend, distribute, install, and proxy the functions of other MCP servers through the MCP Server, helping users utilize MCP services more conveniently. In Proxy mode, it converts SSE and stdio protocol MCP Servers into streamable HTTP protocol MCP Servers via straightforward configuration. The server supports multiple search providers, including Nacos Provider (service-discovery-based search with keyword matching and vector search) and Compass Provider (semantic search with relevance scoring, configurable endpoint with default https://registry.mcphub.io). Search behavior is configurable through environment variables such as COMPASS_API_BASE, SEARCH_MIN_SIMILARITY, and SEARCH_RESULT_LIMIT. The MCP search API returns server name, description, provider information, relevance score, and metadata. Quick Start guides cover Python tooling (search_mcp_server, add_mcp_server, use_tool), uvx usage, pip installation, Docker deployment, and JSON-based integration for applications.

Details

Owner
nacos-group
Language
TypeScript
License
Apache License 2.0
Updated
2025-12-07

Features

Router mode

Default mode that 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

Mode activated by MODE=proxy that converts SSE and stdio protocol MCP Servers into streamable HTTP protocol MCP Servers through simple configuration.

Nacos Provider search

Search MCP servers using Nacos service discovery, with keyword matching and vector similarity search, integrated with the local Nacos instance.

Compass Provider search

Connects to a Compass API endpoint for enhanced search, supporting semantic search and relevance scoring, configurable with a default endpoint of https://registry.mcphub.io.

Vector similarity search and multi-provider aggregation

Provides advanced search capabilities including vector similarity search and aggregation of results from multiple providers.

Search API

Exposes a search interface via MCP that returns server name, description, provider information, relevance score, and additional metadata.

Environment variable driven configuration

Configures search behavior and modes via environment variables (e.g., COMPASS_API_BASE, SEARCH_MIN_SIMILARITY, SEARCH_RESULT_LIMIT) and transport/mode settings.

Quick Start tooling and examples

Provides Python-based tools (search_mcp_server, add_mcp_server, use_tool) and examples for running with uvx, pip, Docker, and JSON integrations for applications.

Audience

DevelopersEnable developers to search, install, and proxy MCP servers for applications.
DevOpsProvide centralized tooling for managing MCP servers in CI/CD pipelines.
MCP integratorsIntegrate MCP server search and proxy capabilities into larger platforms.

Tags

NacosMCPRouterProxySearchInstallVector similarity searchCompass providerNacos providerSSEstdioHTTP