Nacos MCP Server

MCPOpen SourceApache-2.032.5

by nacos-group • Analytics & Monitoring

A read-only MCP server that lets LLM agents query and search Nacos namespaces, services, instances, subscribers, and configuration metadata.

Example Use Cases

1
Discover and list namespaces and services in a Nacos 3.x cluster to support topology-aware automation or documentation.
2
Fetch service details, instance lists, and subscriber information to diagnose service health or dependency relationships.
3
Search, read, and inspect configuration items and their publish history or listeners for configuration auditing and troubleshooting.

Description

This MCP server provides a set of tools for programmatic read/search/list operations against a Nacos 3.x cluster, exposing namespaces, services, instances, subscribers, configurations, and configuration history to LLM-driven agents. It integrates with Claude Desktop and can be run via uv/uvx or installed via pip, simplifying automation and inspection tasks for service discovery and configuration. The project is read-only in the current version (no write operations) and is described as early development. It requires Nacos 3.0.0+ and Python 3.x (recommended >=3.13).

Capabilities(11 total)

Tools (11)

list_namespaces

Retrieves the list of namespaces in the current Nacos cluster.

list_services

This interface retrieves the list of services under a specified namespace. The response format depends on the `withInstances` parameter:`withInstances=true`: Returns service details with instances (`ServiceDetailInfo` objects). `withInstances=false`: Returns service metadata without instances (`ServiceView` objects). **NOTE: ** When `withInstances=true`, The API may cost too much memory and networks, If Only want get instance list with little or one service, Suggest use `withInstances=false` with `List Service Instances`.

pageNo:int*pageSize:int*namespaceId:stringgroupNameParam:stringserviceNameParam:stringignoreEmptyService:boolwithInstances:bool

get_service

This interface retrieves detailed information of a specified service, including metadata and clusters, not including instance list.

namespaceId:stringgroupName:stringserviceName:string*

list_service_instances

This interface retrieves the list of instances for a specified service.

namespaceId:stringgroupName:stringserviceName:string*clusterName:string

list_service_subscribers

This interface retrieves the list of subscribers for a specified service.

pageNo:int*pageSize:int*namespaceId:stringgroupName:stringserviceName:string*aggregation:bool

Quick Actions

View on GitHub

Security

Scanned 3 month(s) ago

Risk Level

LOW

Reads external data but no write or execute capability

Trust Score

C62/100

8/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities11 Tools / 0 Prompts / 0 Resources

Ownernacos-group

CategoryAnalytics & Monitoring

DependenciesStandalone

Set Your Username