MCP Server Ntopng

🚀 mcp-server-ntopng

mcp-server-ntopng 是一個 模型上下文協議 服務器實現，用於與 NTOPNG 對接，允許 AI 模型通過上下文進行交互，解決了 AI 模型與 NTOPNG 之間的數據交互問題，為數據分析等場景提供了支持。

🚀 快速開始

環境變量配置

以下環境變量用於配置數據庫連接：

• NTOPNG_HOST：NTOPNG 服務的主機名。
• NTOPNG_DBUSER：ClickHouse 數據庫的身份驗證用戶名。
• NTOPNG_DBPASSWORD：ClickHouse 數據庫的身份驗證密碼。
• NTOPNG_API_KEY：NTOPNG 的身份驗證令牌。

可選配置

• NTOPNG_DBPORT：ClickHouse 數據庫的端口號，默認值根據 HTTPS 是否啟用而定（HTTPS 啟用默認為 9000，未啟用默認為 8123）。
• NTOPNG_SECURE：啟用/禁用 TLS 連接，默認為 false。
• NTOPNG_VERIFY：啟用/禁用 SSL 證書驗證，默認為 true。
• NTOPNG_CONNECT_TIMEOUT：連接超時時間（秒），默認為 30 秒。
• NTOPNG_SEND_RECEIVE_TIMEOUT：發送/接收超時時間（秒），默認為 300 秒。

安裝與運行

1. 安裝依賴：

$ uv sync

2. 安裝包：

$ uv pip install -e .

3. 啟動服務器（使用示例環境變量）：

$ CLIENT_PORT=8077 SERVER_PORT=8078  mcp dev run_mcp_ntopng.py --with clickhouse-driver --with python-dotenv --with uvicorn --with pip-system-certs

在 Claude Desktop 中使用

編輯路徑：/Users/marco/Library/Application\ Support/Claude/claude_desktop_config.json

修改 claude_desktop_config.json 文件，將本地路徑替換為以下內容：

{
    "mcpServers": {
      "mcp-ntopng": {
        "command": "/Users/marco/Development/claude/mcp-server-ntopng/.venv/bin/python",
        "args": [
           "/Users/marco/Development/claude/mcp-server-ntopng/run_mcp_ntopng.py"
        ],
        "env": {
          "NTOPNG_HOST": "marcoeg-nod004.ntoplink.com",
          "NTOPNG_DBPORT": "9000",
          "NTOPNG_DBUSER": "default",
          "NTOPNG_DBPASSWORD": "",
          "NTOPNG_SECURE": "false",
          "NTOPNG_VERIFY": "false",
          "SELECT_QUERY_TIMEOUT_SECS": "30",
          "NTOPNG_API_KEY": "NTOPNG_TOKEN"
        }
      }
    }
  }

⚠️ 重要提示

請根據實際情況調整上述配置中的路徑和值。

✨ 主要特性

• 支持多種查詢類型：包括即時數據、歷史數據分析等。
• 高效的通信機制：確保模型與 NTOPNG 之間的高效數據交換。
• 靈活的配置選項：支持自定義環境變量來調整服務器行為。