mcp-server-nacos: A Nacos MCP server
@nacos-group
About mcp-server-nacos: A Nacos MCP server
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.
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.
Frequently asked questions
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.
Basic information
More Other MCP servers
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Peekaboo MCP – lightning-fast macOS screenshots for AI agents
steipetePeekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
ACI: Open-Source Infra to Power Unified MCP Servers
aipotheosis-labsACI.dev is the open source tool-calling platform that hooks up 600+ tools into any agentic IDE or custom AI agent through direct function calling or a unified MCP server. The birthplace of VibeOps.
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Comments