Skip to content
Back to search

nacos-mcp-router

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nacos-group--nacos-mcp-router/badge.svg)](/listings/nacos-group--nacos-mcp-router)

HTML

<a href="/listings/nacos-group--nacos-mcp-router"><img src="/api/listings/nacos-group--nacos-mcp-router/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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`](https://docs.astral.sh/uv/) no specific installation is needed. We will use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *nacos-mcp-router*.

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
uvx nacos-mcp-router@latest

Using PIP

Alternatively you can install `nacos-mcp-router` via pip:

pip install nacos-mcp-router

After installation, you can run it as a script using(As an example,Nacos is deployed in standalone mode on the local machine):

export NACOS_ADDR=127.0.0.1:8848
export NACOS_USERNAME=nacos
export NACOS_PASSWORD=$PASSWORD
python -m nacos_mcp_router

Using Docker

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

Usage with Cline、Cursor、Claude and other applications

Add this to MCP settings of your application:

* Using uvx

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

> 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.

* Using docker

{
  "mcpServers": {
    "nacos-mcp-router": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--network", "host",  "-e", "NACOS_ADDR=<NACOS-ADDR>", "-e",  "NACOS_USERNAME=<NACOS-USERNAME>", "-e", "NACOS_PASSWORD=<NACOS-PASSWORD>" ,"-e", "TRANSPORT_TYPE=stdio", "nacos/nacos-mcp-router:latest"
      ]
    }
  }
}

Proxy Mode

The proxy mode supports converting SSE and stdio protocol MCP Servers into streamable HTTP protocol MCP Servers.

Usage

The usage of proxy mode is similar to that of router mode, with slightly different parameters. Docker deployment is recommended.

docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=streamable_http -e MODE=proxy -e PROXIED_MCP_NAME=$PROXIED_MCP_NAME  nacos/nacos-mcp-router:latest

Environment Variable Settings

| Parameter | Description | Default Value | Required | Remarks |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 224 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # nacos-mcp-router: A MCP server that provides functionalities such as search, installation, proxy, and more.
  2. [![Model Context Protocol](https://img.shields.io/badge/Model%20Context%20Protocol-purple)](https://modelcontextprotocol.org)
  3. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/nacos-group/nacos-mcp-router)
  4. ![NPM Version](https://img.shields.io/npm/v/nacos-mcp-router) ![NPM Downloads](https://img.shields.io/npm/d18m/nacos-mcp-router)
  5. <p>
  6. <a href="./README.md">English</a> | <a href="./README_cn.md">简体中文</a>
  7. </p>
  8. ## Overview
  9. [Nacos](https://nacos.io) 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.
  10. 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.
  11. Nacos-MCP-Router has two working modes:
  12. 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.
  13. 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.
  14. ## Search Features
  15. Nacos-MCP-Router provides powerful search capabilities through multiple providers:
  16. ### Search Providers
  17. 1. **Nacos Provider**
  18. - Searches MCP servers using Nacos service discovery
  19. - Supports keyword matching and vector similarity search
  20. - Integrated with the local Nacos instance
  21. 2. **Compass Provider**
  22. - Connects to a COMPASS API endpoint for enhanced search
  23. - Supports semantic search and relevance scoring
  24. - Configurable API endpoint (default: https://registry.mcphub.io)
  25. ### Search Configuration
  26. Configure search behavior using environment variables:
  27. ```bash
  28. # YOUR COMPASS API endpoint (for Outer Provider called Compass Provider)
  29. COMPASS_API_BASE=https://registry.mcphub.io
  30. # Minimum similarity score for results (0.0 to 1.0)
  31. SEARCH_MIN_SIMILARITY=0.5
  32. # Maximum number of results to return
  33. SEARCH_RESULT_LIMIT=10
  34. ```
  35. ### Search API
  36. The search functionality is available through the MCP interface:
  37. ```typescript
  38. // Search for MCP servers
  39. const results = await searchMcpServer(
  40. "Find MCP servers for natural language processing",
  41. ["nlp", "language"]
  42. );
  43. ```
  44. Results include:
  45. - Server name and description
  46. - Provider information
  47. - Relevance score
  48. - Additional metadata
  49. ## Quick Start
  50. ### Python
  51. #### router mode
  52. ##### Tools
  53. 1. `search_mcp_server`
  54. - Search MCP servers by task and keywords.
  55. - Input:
  56. - `task_description`(string): Task description
  57. - `key_words`(string): Keywords of task
  58. - Returns: list of MCP servers and instructions to complete the task.
  59. 2. `add_mcp_server`
  60. - 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
  61. - Input:
  62. - `mcp_server_name`(string): The name of MCP server.
  63. - Returns: tool list of the MCP server and how to use these tools.
  64. 3. `use_tool`
  65. - This tool helps LLM to use the tool of some MCP server. It will proxy requests to the target MCP server.
  66. - Input:
  67. - `mcp_server_name`(string): The target MCP server name that LLM wants to call.
  68. - `mcp_tool_name`(string): The tool name of target MCP server that LLM wants to call.
  69. - `params`(map): The parameters of the MCP tool.
  70. - Returns: Result returned from the target MCP server.
  71. ##### Usage
  72. ###### Using uv (recommended)
  73. When using [`uv`](https://docs.astral.sh/uv/) no specific installation is needed. We will
  74. use [`uvx`](https://docs.astral.sh/uv/guides/tools/) to directly run *nacos-mcp-router*.
  75. ```
  76. export NACOS_ADDR=127.0.0.1:8848
  77. export NACOS_USERNAME=nacos
  78. export NACOS_PASSWORD=$PASSWORD
  79. uvx nacos-mcp-router@latest
  80. ```
  81. ###### Using PIP
  82. Alternatively you can install `nacos-mcp-router` via pip:
  83. ```
  84. pip install nacos-mcp-router
  85. ```
  86. After installation, you can run it as a script using(As an example,Nacos is deployed in standalone mode on the local machine):
  87. ```
  88. export NACOS_ADDR=127.0.0.1:8848
  89. export NACOS_USERNAME=nacos
  90. export NACOS_PASSWORD=$PASSWORD
  91. python -m nacos_mcp_router
  92. ```
  93. ###### Using Docker
  94. ```
  95. 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
  96. ```
  97. ###### Usage with Cline、Cursor、Claude and other applications
  98. Add this to MCP settings of your application:
  99. * Using uvx
  100. ```json
  101. {
  102. "mcpServers":
  103. {
  104. "nacos-mcp-router":
  105. {
  106. "command": "uvx",
  107. "args":
  108. [
  109. "nacos-mcp-router@latest"
  110. ],
  111. "env":
  112. {
  113. "NACOS_ADDR": "<NACOS-ADDR>, optional, default is 127.0.0.1:8848",
  114. "NACOS_USERNAME": "<NACOS-USERNAME>, optional, default is nacos",
  115. "NACOS_PASSWORD": "<NACOS-PASSWORD>, required"
  116. }
  117. }
  118. }
  119. }
  120. ```
  121. > 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.
  122. * Using docker
  123. ```json
  124. {
  125. "mcpServers": {
  126. "nacos-mcp-router": {
  127. "command": "docker",
  128. "args": [
  129. "run", "-i", "--rm", "--network", "host", "-e", "NACOS_ADDR=<NACOS-ADDR>", "-e", "NACOS_USERNAME=<NACOS-USERNAME>", "-e", "NACOS_PASSWORD=<NACOS-PASSWORD>" ,"-e", "TRANSPORT_TYPE=stdio", "nacos/nacos-mcp-router:latest"
  130. ]
  131. }
  132. }
  133. }
  134. ```
  135. #### Proxy Mode
  136. The proxy mode supports converting SSE and stdio protocol MCP Servers into streamable HTTP protocol MCP Servers.
  137. ##### Usage
  138. The usage of proxy mode is similar to that of router mode, with slightly different parameters. Docker deployment is recommended.
  139. ```
  140. docker run -i --rm --network host -e NACOS_ADDR=$NACOS_ADDR -e NACOS_USERNAME=$NACOS_USERNAME -e NACOS_PASSWORD=$NACOS_PASSWORD -e TRANSPORT_TYPE=streamable_http -e MODE=proxy -e PROXIED_MCP_NAME=$PROXIED_MCP_NAME nacos/nacos-mcp-router:latest
  141. ```
  142. #### Environment Variable Settings
  143. | Parameter | Description | Default Value | Required | Remarks |
  144. |-----------|------------------------------------------------------------|---------------|----------|-----------------------------------------------------------------------------------------------|
  145. | NACOS_ADDR | Nacos server address | 127.0.0.1:8848 | No | the Nacos server address, e.g., 192.168.1.1:8848. Note: Include the port. |
  146. | NACOS_USERNAME | Nacos username | nacos | No | the Nacos username, e.g., nacos. |
  147. | NACOS_PASSWORD | Nacos password | - | Yes | the Nacos password, e.g., nacos. |
  148. | COMPASS_API_BASE | COMPASS API endpoint for enhanced search | https://registry.mcphub.io | No | Override the default COMPASS API endpoint |
  149. | SEARCH_MIN_SIMILARITY | Minimum similarity score (0.0-1.0) | 0.5 | No | Filter search results by minimum similarity score |
  150. | SEARCH_RESULT_LIMIT | Maximum number of results to return | 10 | No | Limit the number of search results |
  151. |NACOS_NAMESPACE| Nacos Namespace | public | No | Nacos namespace, e.g. public |
  152. | TRANSPORT_TYPE | Transport protocol type | stdio | No | transport protocol type. Options: stdio, sse, streamable_http. |
  153. | PROXIED_MCP_NAME | Proxied MCP server name | - | No | In proxy mode, specify the MCP server name to be converted. Must be registered in Nacos first. |
  154. | MODE | Working mode | router | No | Available options: router, proxy. |
  155. | PORT| Service port when TRANSPORT_TYPE is sse or streamable_http | 8000| No | |
  156. |ACCESS_KEY_ID | Aliyun ram access key id| - | No | |
  157. |ACCESS_KEY_SECRET | Aliyun ram access key secret | - | No | |
  158. ### typescript
  159. #### Usage with Cline、Cursor、Claude and other applications
  160. ```json
  161. {
  162. "mcpServers": {
  163. "nacos-mcp-router": {
  164. "command": "npx",
  165. "args": [
  166. "nacos-mcp-router@latest"
  167. ],
  168. "env": {
  169. "NACOS_ADDR": "<NACOS-ADDR>, optional, default is 127.0.0.1:8848",
  170. "NACOS_USERNAME": "<NACOS-USERNAME>, optional, default is nacos",
  171. "NACOS_PASSWORD": "<NACOS-PASSWORD>, required"
  172. }
  173. }
  174. }
  175. }
  176. ```
  177. ## License
  178. 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. For more details, please see the `LICENSE` file in the project repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.