Nacos MCP Router

Nacos MCP Router is an MCP server that provides search, installation, and proxy functionalities for managing Model Context Protocol servers through Nacos. It connects to a Nacos service discovery and configuration instance as well as the Compass registry API to expose discovery and routing capabilities to language model clients. Cloud engineers, software developers, and platform operators use Nacos MCP Router to discover relevant tools dynamically, install dependencies, and route execution calls directly to other registered MCP servers. In Router mode, the server uses keyword and vector similarity search to find MCP tools matching a user's task description, attaches connection protocols, and delegates tool calls. In Proxy mode, it translates stdio or Server-Sent Events MCP servers into streamable HTTP endpoints, allowing external clients to communicate with standard microservices over network interfaces. By combining central configuration management with runtime agent tooling, it simplifies large-scale tool registry access.

Category: Cloud & Infrastructure

Tags: configuration-management, nacos, proxy, service-discovery

Visit Nacos MCP Router

How to install and configure Nacos MCP Router

1. Ensure a running Nacos instance is accessible and obtain your credentials. 2. Add the server configuration to your MCP client settings (e.g., Cline, Cursor, or Claude Desktop). Using uvx: json { "mcpServers": { "nacos-mcp-router": { "command": "uvx", "args": ["nacos-mcp-router@latest"], "env": { "NACOS_ADDR": "127.0.0.1:8848", "NACOS_USERNAME": "nacos", "NACOS_PASSWORD": "<NACOS-PASSWORD>" } } } } 3. Alternatively, install via pip using pip install nacos-mcp-router or configure the TypeScript implementation using npx nacos-mcp-router@latest. 4. Restart your MCP client to initialize the server connection.

What you can do with Nacos MCP Router

• Discovering relevant MCP tools through task descriptions and semantic keyword queries against local Nacos instances or Compass registries. - Installing and establishing runtime connections to external stdio or Server-Sent Events servers dynamically upon agent request. - Delegating tool execution calls from an AI assistant to target MCP servers through unified proxy routing. - Converting stdio and Server-Sent Events protocol MCP servers into streamable HTTP protocol endpoints via Proxy mode.

Key facts

• Open Source
• https://github.com/nacos-group/nacos-mcp-router
• Cloud & Infrastructure, Developer Tools & Code Intelligence
• configuration-management, nacos, proxy, service-discovery

Part of MCP Servers

What is Nacos MCP Router?

Nacos MCP Router is an open source Model Context Protocol server that integrates with Nacos for service discovery and configuration. It enables AI agents to discover, install, and execute tools hosted across different MCP servers through router and proxy workflows.

How do I install Nacos MCP Router?

You can run it directly without pre-installation using uvx nacos-mcp-router@latest in your MCP client settings. Alternatively, you can install it via pip with pip install nacos-mcp-router, run the Docker container nacos/nacos-mcp-router:latest, or use npx.

What is the difference between Router mode and Proxy mode?

Router mode is the default mode used to search, recommend, install, and proxy tool calls across registered MCP servers. Proxy mode converts stdio or SSE protocol servers into streamable HTTP servers for network deployment.

Which MCP clients work with Nacos MCP Router?

Nacos MCP Router works with standard MCP-compliant clients including Claude Desktop, Cursor, Cline, and other host environments supporting stdio or streamable transport protocols.

Is Nacos MCP Router open source?

Yes, Nacos MCP Router is open source software distributed under the Apache 2.0 License. The source code is publicly accessible on GitHub.