mcp-server-nacos: A Nacos MCP server
@nacos-group
About mcp-server-nacos: A Nacos MCP server
Nacos MCP Server
Basic information
Config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryTools
22None
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.
FAQ from mcp-server-nacos
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.
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.
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.
Does mcp-server-nacos support pagination?
Yes, many list tools accept pageNo and pageSize parameters to control pagination (default page size is 100).
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.
More Other MCP servers
ghidraMCP
LaurieWiredMCP Server for Ghidra
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
EverArt
modelcontextprotocolModel Context Protocol Servers
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Comments