mcp-server-nacos: A Nacos MCP server

Overview

Nacos is an easy-to-use platform designed for dynamic service discovery and configuration and service management. It helps you to build cloud native applications and microservices platform easily.

This MCP(Model Context Protocol) Server is for Nacos interaction and automation. This server provides tools to search and read namespace, service and configuration relative information in Nacos Cluster via Large Language Models.

Please note that mcp-server-nacos is currently in early development. The functionality and available tools are subject to change and expansion as we continue to develop and improve the server. And also note that mcp-server-nacos only provide read, search and list operation, not support any write operation for current version. Write operation is planning supported in future versions.

One more note that this mcp-server-nacos required version:

1. Nacos version required upper `3.0.0`, because of depended on the [Nacos Admin API](https://nacos.io/en/swagger/admin/) in 3.x.
2. python version required 3.x, recommend upper `3.13`.

Tools

1. list_namespaces
   • Retrieves the list of namespaces in the current Nacos cluster.
   • Input:
     • None
   • Returns: list of namespaces in the current Nacos cluster.
2. list_services
   • This tool 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.
   • Input:
     • pageNo(number): The current page number, default is 1.
     • pageSize(number): The size of services in each page, default is 100.
     • namespaceId(string, optional): The namespaceId of services, default is public if missing.
     • groupNameParam(string, optional): The groupName pattern of services, default null means all group if missing.
     • serviceNameParam(string, optional): The serviceName pattern of services, default null means all service if missing.
     • ignoreEmptyService(bool, optional): Whether ignore the empty service in result, default is true.
     • withInstances(bool, optional): Whether contain instances under each services in result, recommend and default is false.
   • Returns: list of services under a specified namespace.
3. get_service
   • This tool retrieves detailed information of a specified service, including metadata and clusters, not including instance list.
   • Input:
     • namespaceId(string, optional): The namespaceId of services, default is public if missing.
     • groupName(string, optional): The groupName pattern of services, default is DEFAULT_GROUP if missing.
     • serviceName(string): The serviceName pattern of services, required.
   • Returns: detailed information of a specified service.
4. list_service_instances
   • This tool retrieves the list of instances for a specified service.
   • Input:
     • namespaceId(string, optional): The namespaceId of services, default is public if missing.
     • groupName(string, optional): The groupName pattern of services, default is DEFAULT_GROUP if missing.
     • serviceName(string): The serviceName pattern of services, required.
     • clusterName(string, optional): The cluster name of instances in service, optional and default is null means match all cluster.
   • Returns: list of instances for a specified service.
5. list_service_subscribers
   • This tool retrieves the list of subscribers for a specified service.
   • Input:
     • pageNo(number): The current page number, default is 1.
     • `pa

... View full README on GitHub