Nacos MCP Server

Nacos MCP服務器，提供基於LLM的Nacos集群交互與自動化工具

開發者工具雲平臺 #服務發現 #配置管理 #微服務 #Nacos工具 .Python

評分 : 2.5分

下載量 : 18

更新時間 : 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"
    ]
  }
}