关键词

Nacos服务发现配置管理LLM工具AI集成

项目简介

本项目是一个基于 Model Context Protocol (MCP) 实现的服务器，专门用于连接大型语言模型 (LLM) 与 Nacos 平台。它将 Nacos 的服务发现和配置管理能力通过标准化的工具接口暴露给 LLM 客户端，允许 LLM 查询 Nacos 中的服务、实例、配置等信息。

主要功能点

该MCP服务器目前提供了一系列查询 Nacos 信息的工具，主要包括：

  • 命名空间管理: 查询 Nacos 集群中的命名空间列表。
  • 服务管理:
    • 列出指定命名空间下的服务。
    • 获取特定服务的详细信息（不包含实例列表）。
    • 列出特定服务下的实例。
    • 列出订阅特定服务的客户端列表。
  • 配置管理:
    • 列出指定命名空间下的配置列表。
    • 获取特定配置的详细内容。
    • 查询特定配置的发布历史。
    • 获取特定配置历史版本的详细信息。
    • 列出订阅特定配置的客户端列表。
    • 列出特定客户端 IP 订阅的所有配置。

请注意，当前版本主要支持信息的读取和查询操作，暂不支持对 Nacos 数据进行写入或修改。

安装步骤

使用 Python 的包管理器 'pip' 进行安装：

  1. 确保您已安装 Python 3.x (建议 3.13+) 和 Nacos 3.0.0+ 版本。

  2. 打开终端或命令行工具。

  3. 运行以下命令安装：

    pip install mcp-server-nacos

服务器配置

MCP 服务器需要由兼容的 MCP 客户端（如 Claude Desktop）来启动和管理连接。您需要在 MCP 客户端的配置中添加此服务器的信息。配置通常是一个 JSON 文件（例如 'claude_desktop_config.json'），您需要添加类似以下结构的条目：

"mcpServers": {
  "nacos": {  // 给这个服务器起一个易于识别的名称，例如 "nacos"
    "command": "python", // 启动服务器的可执行命令
    "args": [
      "-m", "mcp_server_nacos", // 启动安装好的 Python 模块
      "--host", "your_nacos_host", // 替换为您的 Nacos 服务器主机名或IP地址
      "--port", "your_nacos_main_port", // 替换为您的 Nacos 服务器主端口，例如 8848
      "--access_token", "your_nacos_access_token" // 如果 Nacos 开启了认证，替换为有效的访问令牌。令牌可以通过Nacos登录API获取。
    ]
  }
}

请根据您的实际 Nacos 服务器地址、端口和认证设置替换 'your_nacos_host', 'your_nacos_main_port', 和 'your_nacos_access_token'。

基本使用方法

  1. 按照上述步骤安装 'mcp-server-nacos'。
  2. 将上述配置信息添加到您的 MCP 客户端的配置文件中。
  3. 启动或重启您的 MCP 客户端。客户端会自动发现并尝试连接配置好的 MCP 服务器。
  4. 连接成功后，您就可以通过 LLM 客户端与 Nacos 进行交互了。例如，您可以尝试对 LLM 说：“请列出 Nacos 中所有命名空间” 或 “请帮我查找服务名为 'my-service' 的详细信息”。LLM 将会调用相应的 Nacos MCP 服务器工具来获取信息并回复您。

信息

分类

开发者工具

访问项目