mcp-server-nacos: A Nacos MCP server

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.