Nacos MCP Server

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

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

評分 : 2.5分

下載量 : 8.7K

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