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
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
Blender
ahujasidOpen-source MCP to use Blender with any LLM
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
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Comments