Nacos MCP Server
Officialmcp-server-nacos: Un servidor MCP de Nacos
Descripción general
Nacos es una plataforma fácil de usar diseñada para el descubrimiento, la configuración y la gestión dinámica de servicios. Facilita la creación de aplicaciones nativas de la nube y plataformas de microservicios.
Este servidor MCP (Protocolo de Contexto de Modelo) facilita la interacción y automatización de Nacos. Proporciona herramientas para buscar y leer información relativa a namespace , service y configuration en el clúster de Nacos mediante grandes modelos de lenguaje.
Tenga en cuenta que mcp-server-nacos se encuentra actualmente en desarrollo inicial. La funcionalidad y las herramientas disponibles están sujetas a cambios y ampliaciones a medida que continuamos desarrollando y mejorando el servidor. Tenga en cuenta también que mcp-server-nacos solo ofrece operaciones de lectura, búsqueda y lista, y no admite operaciones de escritura en la versión actual. Se prevé que la operación de escritura sea compatible en futuras versiones.
Una nota más: esta versión requerida de mcp-server-nacos :
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`.Herramientas
list_namespacesRecupera la lista de espacios de nombres en el clúster Nacos actual.
Aporte:
Ninguno
Devuelve: lista de espacios de nombres en el clúster Nacos actual.
list_servicesEsta herramienta recupera la lista de servicios bajo un espacio de nombres específico. El formato de la respuesta depende del parámetro
withInstances:withInstances=true: Devuelve los detalles del servicio con instancias (objetosServiceDetailInfo).withInstances=false: Devuelve los metadatos del servicio sin instancias (objetosServiceView). **NOTA:** SiwithInstances=truees cierto, la API puede consumir demasiada memoria y red. Si solo se desea obtener la lista de instancias con un solo servicio o pocos, se recomienda usarwithInstances=falsecon la opciónList Service Instances.Aporte:
pageNo(número): el número de página actual, el valor predeterminado es 1.pageSize(número): el tamaño de los servicios en cada página, el valor predeterminado es 100.namespaceId(cadena, opcional): el namespaceId de los servicios, el valor predeterminado espublicsi falta.groupNameParam(cadena, opcional): el patrón groupName de los servicios, el valor predeterminado es nulo, lo que significa todos los grupos si faltan.serviceNameParam(cadena, opcional): el patrón serviceName de los servicios, el valor predeterminado es nulo, lo que significa todos los servicios si faltan.ignoreEmptyService(bool, opcional): si se ignora el servicio vacío en el resultado, el valor predeterminado es verdadero.withInstances(bool, opcional): si contiene instancias bajo cada servicio en el resultado, se recomienda y el valor predeterminado es falso.
Devuelve: lista de servicios bajo un espacio de nombres especificado.
get_serviceEsta herramienta recupera información detallada de un servicio específico, incluidos metadatos y clústeres, sin incluir la lista de instancias.
Aporte:
namespaceId(cadena, opcional): el namespaceId de los servicios, el valor predeterminado espublicsi falta.groupName(cadena, opcional): el patrón groupName de los servicios, el valor predeterminado esDEFAULT_GROUPsi falta.serviceName(cadena): el patrón serviceName de los servicios, obligatorio.
Devoluciones: información detallada de un servicio especificado.
list_service_instancesEsta herramienta recupera la lista de instancias de un servicio específico.
Aporte:
namespaceId(cadena, opcional): el namespaceId de los servicios, el valor predeterminado espublicsi falta.groupName(cadena, opcional): el patrón groupName de los servicios, el valor predeterminado esDEFAULT_GROUPsi falta.serviceName(cadena): el patrón serviceName de los servicios, obligatorio.clusterName(cadena, opcional): el nombre del clúster de instancias en servicio, opcional y el valor predeterminado es nulo, lo que significa que coincide con todos los clústeres.
Devuelve: lista de instancias para un servicio especificado.
list_service_subscribersEsta herramienta recupera la lista de suscriptores de un servicio específico.
Aporte:
pageNo(número): el número de página actual, el valor predeterminado es 1.pageSize(número): el tamaño de los suscriptores del servicio en cada página, el valor predeterminado es 100.namespaceId(cadena, opcional): el namespaceId de los servicios, el valor predeterminado espublicsi falta.groupName(cadena, opcional): el patrón groupName de los servicios, el valor predeterminado esDEFAULT_GROUPsi falta.serviceName(cadena): el patrón serviceName de los servicios, obligatorio.aggregation(bool, opcional): si se realiza la agregación desde todo el clúster.
Devuelve: lista de suscriptores para un servicio específico.
list_configsEsta herramienta recupera la lista de configuraciones bajo un espacio de nombres especificado.
Aporte:
pageNo(número): el número de página actual, el valor predeterminado es 1.pageSize(número): el tamaño de las configuraciones en cada página, el valor predeterminado es 100.namespaceId(cadena, opcional): el namespaceId de las configuraciones, el valor predeterminado espublicsi falta.groupName(cadena, opcional): el patrón groupName de las configuraciones, el valor predeterminado nulo significa todos los grupos.dataId(cadena, opcional): el patrón dataId de las configuraciones, el valor predeterminado nulo significa todos los dataId.type(cadena, opcional): el tipo de configuraciones, el valor predeterminado nulo significa todos los tipos.configTags(cadena, opcional): las etiquetas de las configuraciones, el valor predeterminado nulo significa todas las etiquetas.appName(cadena, opcional): el nombre de la aplicación de las configuraciones, el valor predeterminado nulo significa todos los nombres de las aplicaciones.search(cadena, opcional): la forma de búsqueda de las configuraciones de lista, el valor predeterminado esblur, el valor opcionalaccurate.
Devuelve: lista de configuraciones bajo un espacio de nombres especificado.
get_configrecupera los detalles de la configuración especificada.
Aporte:
namespaceId(cadena, opcional): el namespaceId de las configuraciones, el valor predeterminado espublicsi falta.groupName(cadena): el nombre del grupo de la configuración, obligatorio.dataId(cadena): el dataId de la configuración, obligatorio.
Devuelve: los detalles de la configuración especificada.
list_config_historyEsta herramienta recupera el historial de publicación completo de una configuración.
Aporte:
pageNo(número): el número de página actual, el valor predeterminado es 1.pageSize(número): el tamaño de los registros del historial de configuración en cada página, el valor predeterminado es 100.namespaceId(cadena, opcional): el namespaceId de las configuraciones, el valor predeterminado espublicsi falta.groupName(cadena): el nombre del grupo de la configuración, obligatorio.dataId(cadena): el dataId de la configuración, obligatorio.
Devuelve: lista de configuraciones bajo un espacio de nombres especificado.
get_config_historyrecupera un registro de cambio histórico específico de una configuración.
Aporte:
namespaceId(cadena, opcional): el namespaceId de las configuraciones, el valor predeterminado espublicsi falta.groupName(cadena): el nombre del grupo de la configuración, obligatorio.dataId(cadena): el dataId de la configuración, obligatorio.nid(número): el ID real del registro del historial de configuración, obtenido de la herramienta de historial de configuración de lista, campoid.
Devuelve: registro histórico de cambios de una configuración.
list_config_listeners
recupera la lista de oyentes suscritos a una configuración específica.
Aporte:
namespaceId(cadena, opcional): el namespaceId de las configuraciones, el valor predeterminado espublicsi falta.groupName(cadena): el nombre del grupo de la configuración, obligatorio.dataId(cadena): el dataId de la configuración, obligatorio.aggregation(bool, opcional): si se realiza la agregación desde todo el clúster.
Devuelve: lista de oyentes suscritos a una configuración específica.
list_listened_configs
recupera listas de las configuraciones suscritas por una dirección IP de cliente específica.
Aporte:
namespaceId(cadena, opcional): el namespaceId de las configuraciones, el valor predeterminado espublicsi falta.ip(cadena): la IP del cliente de los oyentes de configuración. Obligatorio.aggregation(bool, opcional): si se realiza la agregación desde todo el clúster.
Devuelve: enumera las configuraciones suscritas por una dirección IP de cliente específica.
Related MCP server: jewei-mcp-nacos
Instalación
Uso de uv (recomendado)
Al usar uv no se requiere ninguna instalación específica. Usaremos uvx para ejecutar directamente mcp-server-nacos .
Uso de PIP
Alternativamente, puede instalar mcp-server-nacos a través de pip:
pip install mcp-server-nacosDespués de la instalación, puedes ejecutarlo como un script usando:
python -m mcp_server_nacosConfiguración
Uso con Claude Desktop
Agregue esto a su claude_desktop_config.json :
"mcpServers": {
"git": {
"command": "uvx",
"args": [
"nacos-mcp-server",
"--host",
"your_nacos_host",
"--port",
"your_nacos_main_port, such as 8848",
"--access_token",
"your_nacos_access_token, get from `login` api: /nacos/v3/auth/user/login with `username` and `password`"
],
}
}Es posible que necesites introducir la ruta completa del ejecutable
uvxen el campocommand. Puedes obtenerla ejecutandowhich uvxen macOS/Linux owhere uvxen Windows.
"mcpServers": {
"git": {
"command": "python",
"args": [
"-m",
"nacos-mcp-server",
"--host",
"your_nacos_host",
"--port",
"your_nacos_main_port, such as 8848",
"--access_token",
"your_nacos_access_token, get from `login` api: /nacos/v3/auth/user/login with `username` and `password`"
],
}
}Desarrollo
Si está realizando desarrollo local, simplemente siga los pasos:
Clone este repositorio en su entorno local.
Modifique los códigos en
src/mcp_server_nacospara implementar las funciones deseadas.Prueba con la aplicación de escritorio Claude. Agrega lo siguiente a tu archivo claude_desktop_config.json:
{
"mcpServers": {
"mcp-server-nacos": {
"command": "uv",
"args": [
"--directory",
"/<path to mcp-server-nacos>/src/mcp_server_nacos",
"run",
"mcp-server-nacos"
]
}
}Licencia
mcp-server-nacos está licenciado bajo la Licencia Apache 2.0. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia Apache 2.0. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.
Available Tools
11 toolsget_configC
This interface retrieves the details of the specified configuration.
Inputs: groupName (required), dataId (required), namespaceId.
get_config_historyB
This interface retrieves a specific historical change record of a configuration.
Inputs: groupName (required), dataId (required), namespaceId, nid.
get_serviceA
This interface retrieves detailed information of a specified service, including metadata and clusters, not including instance list.
Inputs: serviceName (required), namespaceId, groupName.
list_config_historyC
This interface retrieves the complete publish history of a configuration.
Inputs: pageNo (required), pageSize (required), groupName (required), dataId (required), +1 more.
list_config_listenersB
This interface retrieves the list of listeners subscribed to a specific configuration.
Inputs: groupName (required), dataId (required), namespaceId, aggregation.
list_configsC
This interface retrieves the list of configurations under a specified namespace.
Inputs: pageNo (required), pageSize (required), namespaceId, groupName, +5 more.
list_listened_configsC
This interface lists the configurations subscribed to by a specific client IP address.
Inputs: ip (required), namespaceId, aggregation.
list_namespacesB
Retrieves the list of namespaces in the current Nacos cluster.
Inputs: no named parameters.
list_service_instancesC
This interface retrieves the list of instances for a specified service.
Inputs: serviceName (required), namespaceId, groupName, clusterName.
list_servicesA
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.
Inputs: pageNo (required), pageSize (required), namespaceId, groupNameParam, +3 more.
list_service_subscribersC
This interface retrieves the list of subscribers for a specified service.
Inputs: pageNo (required), pageSize (required), serviceName (required), namespaceId, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Every tool has a clearly distinct purpose targeting specific resources and actions in the Nacos domain (configurations, services, namespaces, listeners/subscribers). No tools appear to overlap or cause confusion, as each name precisely indicates its function, such as get_config vs. list_configs or get_service vs. list_services.
All tool names follow a consistent verb_noun pattern with snake_case throughout, using clear verbs like 'get', 'list', and specific nouns like 'config', 'service', 'namespace'. There are no deviations or mixed conventions, making the naming highly predictable and readable.
With 11 tools, this server is well-scoped for managing configurations and services in Nacos, covering key operations like retrieval, listing, and history tracking. Each tool earns its place without feeling excessive or insufficient for the domain's needs.
The tool set provides strong coverage for read operations on configurations, services, namespaces, and related metadata, but lacks explicit create, update, or delete tools for these resources. This minor gap means agents can query effectively but may need workarounds for full lifecycle management.
Maintenance
Related MCP Connectors
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
MCP server for AI dialogue using various LLM models via AceDataCloud
The Needle MCP server enables semantic search on documents stored in files like PDFs, DOCX, and XLSX by connecting AI applications to external data sources. It provides capabilities to create and manage document collections, perform natural language searches on stored content, and retrieve relevant information without requiring exact keyword matches.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA server that enables LLMs to interact with Lark/Feishu services, currently supporting employee information queries via Lark's Contact API.3-
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to query and manage Nacos configurations. It supports Nacos 3.x for retrieving or publishing configuration files and includes an optional read-only mode for secure environments.23MIT
- AlicenseAqualityDmaintenanceMCP server that exposes all AgileConfig RESTful APIs as tools, enabling AI assistants to manage configuration, applications, users, nodes, and more via natural language.368 npmMIT
- AlicenseAqualityCmaintenanceEnables AI assistants to query and manage Nacos configurations, supporting Nacos 1.x/2.x/3.x with multiple transport protocols.751 PyPI1MIT