Nacos Mcp Router

by nacos-group

180 stars
258 downloads
Not rated
GitHub

About

# nacos-mcp-router: A MCP server that provides functionalities such as search, installation, proxy, and more. [![Model Context Protocol](https://img.shields.io/badge/Model%20Context%20Protocol-purple)](https://modelcontextprotocol.org) [![Ask…

Details

Author
nacos-group
GitHub stars
180
Downloads
258
Categories
Cloud Service, Infrastructure, Other

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Nacos Mcp Router
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

search_mcp_server

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

add_mcp_server

安装指定的mcp server

use_tool

使用某个MCP Server的工具

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "nacos mcp router": {
            "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"
                }
            }
        }
    }
}

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"
        }
    }
}

nacos-mcp-router: A MCP server that provides functionalities such as search, installation, proxy, and more.

Model Context Protocol Ask DeepWiki NPM Version NPM Downloads

<p>
<a href="./README.md">English</a> | <a href="./README_cn.md">简体中文</a>
</p>

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:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.