Advertise
MCP.so
Sign In

mcp-server-nacos: A Nacos MCP server

@nacos-group

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

nacos-group

About mcp-server-nacos: A Nacos MCP server

Nacos MCP Server

mcp-server-nacos: A Nacos MCP server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

mcp-server-nacos: A Nacos MCP server tools

22

None

list of namespaces in the current Nacos cluster.

`pageNo`(number): The current page number, default is 1.

list of services under a specified namespace.

`namespaceId`(string, optional): The namespaceId of services, default is `public` if missing.

detailed information of a specified service.

`namespaceId`(string, optional): The namespaceId of services, default is `public` if missing.

list of instances for a specified service.

`pageNo`(number): The current page number, default is 1.

list of subscribers for a specified service.

`pageNo`(number): The current page number, default is 1.

list of configurations under a specified namespace.

`namespaceId`(string, optional): The namespaceId of configs, default is `public` if missing.

the details of the specified configuration.

`pageNo`(number): The current page number, default is 1.

list of configurations under a specified namespace.

`namespaceId`(string, optional): The namespaceId of configs, default is `public` if missing.

historical change record of a configuration.

`namespaceId`(string, optional): The namespaceId of configs, default is `public` if missing.

list of listeners subscribed to a specific configuration.

`namespaceId`(string, optional): The namespaceId of configs, default is `public` if missing.

lists the configurations subscribed to by a specific client IP address.

Overview

What is mcp-server-nacos?

mcp-server-nacos is an MCP (Model Context Protocol) server for interacting with a Nacos cluster. It enables large language models to search and read namespace, service, and configuration information. It is designed for users who need to query Nacos resources programmatically through an LLM.

How to use mcp-server-nacos?

Install via pip install mcp-server-nacos and run with python -m mcp_server_nacos, or use uvx directly. Configure it by adding an entry to your claude_desktop_config.json under mcpServers, specifying the Nacos host, port, and access token obtained from the Nacos login API.

Key features of mcp-server-nacos

  • Read-only access to Nacos namespaces, services, and configurations.
  • Provides 11 tools for listing and retrieving details.
  • Supports filtering by namespace, group, service name, and more.
  • Works with Nacos version 3.0.0 and above.
  • Early development stage with planned write operations.

Use cases of mcp-server-nacos

  • Querying the list of namespaces in a Nacos cluster via an LLM.
  • Retrieving service instances and subscribers for troubleshooting.
  • Reading configuration values and their change history.
  • Exploring configuration listeners and client subscriptions.

Frequently asked questions

1

What operations does mcp-server-nacos support?

It currently supports only read, search, and list operations. No write operations are available; write support is planned for future versions.

2

What are the runtime requirements?

Nacos version 3.0.0 or higher is required. Python version should be 3.x, with 3.13 or higher recommended.

3

How do I authenticate with the Nacos cluster?

You must provide an `access_token` obtained from the Nacos login API (`/nacos/v3/auth/user/login`) using your username and password.

4

Does mcp-server-nacos support pagination?

Yes, many list tools accept `pageNo` and `pageSize` parameters to control pagination (default page size is 100).

5

Where does mcp-server-nacos store data?

It does not store any data locally; it queries the Nacos cluster directly via the Nacos Admin API.

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
Advertise