Nacos MCP Server

Nacos MCP服务器，提供基于LLM的Nacos集群交互与自动化工具

开发者工具云平台 #服务发现 #配置管理 #微服务 #Nacos工具 .Python

评分 : 2.5分

下载量 : 13

更新时间 : 2025-04-28

什么是mcp-server-nacos?

mcp-server-nacos是一个基于Nacos的服务发现和配置管理平台的MCP服务器。它允许用户通过自然语言查询来获取Nacos集群中的各种信息，包括命名空间、服务和配置等。

如何使用mcp-server-nacos?

您可以通过安装Python包或使用uv工具来运行mcp-server-nacos，然后通过Claude桌面应用或其他兼容MCP协议的客户端与之交互。

适用场景

适用于需要快速查询Nacos集群信息的开发人员、运维人员和系统管理员，特别是在需要自动化处理Nacos数据或通过自然语言查询的场景。

主要功能

列出命名空间检索当前Nacos集群中的所有命名空间列表

列出服务获取指定命名空间下的服务列表，可选择是否包含实例信息

获取服务详情获取指定服务的详细信息，包括元数据和集群信息

列出服务实例获取指定服务的所有实例列表

列出配置检索指定命名空间下的配置列表

获取配置详情获取指定配置的详细内容

优势与局限性

优势

提供自然语言查询Nacos集群的能力

支持多种Nacos资源类型的查询

易于与现有工具集成

减少直接操作Nacos API的学习成本

局限性

当前版本仅支持读取操作，不支持写入

需要Nacos 3.0.0及以上版本

某些查询可能消耗较多内存和网络资源

如何使用

安装

使用pip安装mcp-server-nacos包或使用uv工具直接运行

配置

在Claude桌面应用的配置文件中添加mcp-server-nacos的配置

运行

启动Claude桌面应用，即可开始使用自然语言查询Nacos信息

使用案例

查询生产环境的服务列表用户需要了解生产环境命名空间下的所有服务

检查特定配置的历史变更用户需要查看某个配置的历史变更记录

常见问题

mcp-server-nacos支持哪些Nacos版本?

是否支持写入操作?

如何获取访问令牌?

🚀 MCP-Server-Nacos 中文文档

MCP-Server-Nacos 是用于特定功能的服务，可与 Nacos 进行交互，支持多种安装方式，方便不同场景使用。

🚀 快速开始

本项目提供了多种使用方式，你可以根据自身需求选择合适的安装和配置方法。

📦 安装指南

使用 uv（推荐）

当使用 uv 时，默认不需要进行特定安装。我们可以直接使用 uvx 运行 mcp-server-nacos。

使用 PIP

或者，你可以通过 pip 安装 mcp-server-nacos：

pip install mcp-server-nacos

安装完成后，可以通过以下命令运行它：

python -m mcp_server_nacos

🛠️ 配置说明

与 Claude Desktop 使用

在你的 claude_desktop_config.json 中添加以下内容：

使用 uvx

"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`"
      ],
  }
}

⚠️ 重要提示

你可能需要在 command 字段中放入 uvx 可执行文件的完整路径。你可以在 MacOS/Linux 上运行 which uvx 或 Windows 上运行 where uvx 来获取此路径。

使用 pip 安装

"mcpServers": {
  "mcp-server-nacos": {
    "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`"
      ],
  }
}

💻 开发指引

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

将此仓库克隆到你的本地环境中。
修改 src/mcp_server_nacos 中的代码以实现你想要的功能。
测试时使用 Claude 桌面应用程序。在你的 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"
    ]
  }
}