mcp-server-nacos: 一个 Nacos MCP 服务器

概述

Nacos 是一个易于使用的平台，专为动态服务发现、配置和服务管理而设计。它可以帮助您轻松构建云原生应用程序和微服务平台。

此 MCP（模型上下文协议）服务器用于 Nacos 交互和自动化。该服务器提供工具，通过大型语言模型在 Nacos 集群中搜索和读取 namespace、service 和 configuration 的相关信息。

请注意，mcp-server-nacos 目前处于早期开发阶段。随着我们不断开发和改进服务器，功能和可用工具可能会发生变化和扩展。另请注意，mcp-server-nacos 当前版本仅提供读取、搜索和列表操作，不支持任何写入操作。写入操作计划在未来版本中支持。

另外请注意，此 mcp-server-nacos 需要 Nacos 版本高于 3.0.0，因为它依赖于 3.x 中的 Nacos Admin API。

工具

1. list_namespaces
   • 检索当前 Nacos 集群中的命名空间列表。
   • 输入：
     • 无
   • 返回：当前 Nacos 集群中的命名空间列表。
2. list_services
   • 此工具检索指定命名空间下的服务列表。响应格式取决于 withInstances 参数：withInstances=true: 返回带有实例的服务详细信息（ServiceDetailInfo 对象）。withInstances=false: 返回不带实例的服务元数据（ServiceView 对象）。注意： 当 withInstances=true 时，API 可能会消耗过多的内存和网络资源。如果只想获取少量或一个服务的实例列表，建议使用 withInstances=false 和 List Service Instances。
   • 输入：
     • pageNo(number): 当前页码，默认为 1。
     • pageSize(number): 每页的服务数量，默认为 100。
     • namespaceId(string, optional): 服务的 namespaceId，如果缺失，则默认为 public。
     • groupNameParam(string, optional): 服务的 groupName 模式，如果缺失，则 null 表示所有组。
     • serviceNameParam(string, optional): 服务的 serviceName 模式，如果缺失，则 null 表示所有服务。
     • ignoreEmptyService(bool, optional): 是否忽略结果中的空服务，默认为 true。
     • withInstances(bool, optional): 结果中是否包含每个服务下的实例，推荐且默认为 false。
   • 返回：指定命名空间下的服务列表。
3. get_service
   • 此工具检索指定服务的详细信息，包括元数据和集群，不包括实例列表。
   • 输入：
     • namespaceId(string, optional): 服务的 namespaceId，如果缺失，则默认为 public。
     • groupName(string, optional): 服务的 groupName 模式，如果缺失，则默认为 DEFAULT_GROUP。
     • serviceName(string): 服务的 serviceName 模式，必需。
   • 返回：指定服务的详细信息。
4. list_service_instances
   • 此工具检索指定服务的实例列表。
   • 输入：
     • namespaceId(string, optional): 服务的 namespaceId，如果缺失，则默认为 public。
     • groupName(string, optional): 服务的 groupName 模式，如果缺失，则默认为 DEFAULT_GROUP。
     • serviceName(string): 服务的 serviceName 模式，必需。
     • clusterName(string, optional): 服务中实例的集群名称，可选，默认为 null 表示匹配所有集群。
   • 返回：指定服务的实例列表。
5. list_service_subscribers
   • 此工具检索指定服务的订阅者列表。
   • 输入：
     • pageNo(number): 当前页码，默认为 1。
     • pageSize(number): 每页的服务订阅者数量，默认为 100。
     • namespaceId(string, optional): 服务的 namespaceId，如果缺失，则默认为 public。
     • groupName(string, optional): 服务的 groupName 模式，如果缺失，则默认为 DEFAULT_GROUP。
     • serviceName(string): 服务的 serviceName 模式，必需。
     • aggregation(bool, optional): 是否从整个集群进行聚合。
   • 返回：指定服务的订阅者列表。
6. list_configs
   • 此工具检索指定命名空间下的配置列表。
   • 输入：
     • pageNo(number): 当前页码，默认为 1。
     • pageSize(number): 每页的配置数量，默认为 100。
     • namespaceId(string, optional): 配置的 namespaceId，如果缺失，则默认为 public。
     • groupName(string, optional): 配置的 groupName 模式，如果缺失，则 null 表示所有组。
     • dataId(string, optional): 配置的 dataId 模式，如果缺失，则 null 表示所有 dataId。
     • type(string, optional): 配置的类型，如果缺失，则 null 表示所有类型。
     • configTags(string, optional): 配置的标签，如果缺失，则 null 表示所有标签。
     • appName(string, optional): 配置的 appName，如果缺失，则 null 表示所有 appName。
     • search(string, optional): 列表配置的搜索方式，默认为 blur，可选值为 accurate。
   • 返回：指定命名空间下的配置列表。
7. get_config
   • 检索指定配置的详细信息。
   • 输入：
     • namespaceId(string, optional): 配置的 namespaceId，如果缺失，则默认为 public。
     • groupName(string): 配置的 groupName，必需。
     • dataId(string): 配置的 dataId，必需。
   • 返回：指定配置的详细信息。
8. list_config_history
   • 此工具检索配置的完整发布历史记录。
   • 输入：
     • pageNo(number): 当前页码，默认为 1。
     • pageSize(number): 每页的配置历史记录数量，默认为 100。
     • namespaceId(string, optional): 配置的 namespaceId，如果缺失，则默认为 public。
     • groupName(string): 配置的 groupName，必需。
     • dataId(string): 配置的 dataId，必需。
   • 返回：指定命名空间下的配置列表。
9. get_config_history
   • 检索配置的特定历史更改记录。
   • 输入：
     • namespaceId(string, optional): 配置的 namespaceId，如果缺失，则默认为 public。
     • groupName(string): 配置的 groupName，必需。
     • dataId(string): 配置的 dataId，必需。
     • nid(number): 配置历史记录的实际 ID，从 list config history 工具的 id 字段获取。
   • 返回：配置的历史更改记录。
10. list_config_listeners
    • 检索订阅特定配置的侦听器列表。
    • 输入：
      • namespaceId(string, optional): 配置的 namespaceId，如果缺失，则默认为 public。
      • groupName(string): 配置的 groupName，必需。
      • dataId(string): 配置的 dataId，必需。
      • aggregation(bool, optional): 是否从整个集群进行聚合。
    • 返回：订阅特定配置的侦听器列表。
11. list_listened_configs
    • 列出特定客户端 IP 地址订阅的配置。
    • 输入：
      • namespaceId(string, optional): 配置的 namespaceId，如果缺失，则默认为 public。
      • ip(string): 配置侦听器的客户端 IP，必需。
      • aggregation(bool, optional): 是否从整个集群进行聚合。
    • 返回：列出特定客户端 IP 地址订阅的配置。

安装

TODO

配置

TODO

开发

如果您正在进行本地开发，只需按照以下步骤操作：

1. 将此 repo 克隆到您的本地环境。
2. 修改 src/mcp_server_nacos 中的代码以实现您想要的功能。
3. 使用 Claude 桌面应用程序进行测试。将以下内容添加到您的 claude_desktop_config.json 中：

{
"mcpServers": {
  "mcp-server-nacos": {
    "command": "uv",
    "args": [ 
      "--directory",
      "/<mcp-server-nacos 路径>/src/mcp_server_nacos",
      "run",
      "mcp-server-nacos"
    ]
  }
}

许可证

mcp-server-nacos 在 Apache 2.0 许可证下获得许可。这意味着您可以自由使用、修改和分发该软件，但须遵守 Apache 2.0 许可证的条款和条件。有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。