MCP Ntopng

🚀 mcp-ntopng

mcp-ntopng 是一個專為網絡監控軟件 ntopng 打造的 MCP 服務器，具備輕量版的特性，能有效助力網絡監控工作。

🚀 快速開始

✨ 主要特性

• 輕量級設計，適用於網絡監控軟件 ntopng。
• 支持不同傳輸類型，可在 MCP Inspector 中自由切換。

📦 安裝指南

環境配置

1. 前置條件：
   • 需要 Python 3.13 或更高版本。
   • 需安裝 uv 包管理工具，安裝說明。
2. 克隆倉庫：

git clone https://github.com/marcoeg/mcp-nvd
cd mcp-nvd

3. 設置環境變量： 在項目根目錄下創建一個 .env 文件，並添加以下必要的環境變量：

NTOPNG_HOST=localhost
NTOPNG_PORT=9000
NTOPNG_USER=default
NTOPNG_PASSWORD=

4. 安裝依賴項：

uv sync
uv pip install -e .

💻 使用示例

基礎用法

使用 MCP Inspector 運行：

cd /path/to/the/repo
source .env

CLIENT_PORT=8077 SERVER_PORT=8078 npx @modelcontextprotocol/inspector uv \
    --directory /path/to/repo/mcp-ntopng run mcp-ntopng

然後在瀏覽器中打開 MCP Inspector 指定的 URL，通常為 http://localhost:8077?proxyPort=8078。連接後，列出工具，選擇 query_ntopng_database 並輸入一個 SELECT 語句，例如 SELECT * FROM host_alerts_view LIMIT 2。

高級用法

運行服務器：

cd /path/to/the/repo
source .env

uv run mcp-ntopng --transport sse --port 9090

• 默認在端口 9090 上使用 SSE 傳輸運行。

⚠️ 重要提示

在運行服務器的終端中，會顯示所有活動的完整日誌，這對於調試非常有用。

💡 使用建議

可以在 MCP Inspector 中自由切換 stdio 和 sse 傳輸類型。要使用 sse，請按照上述運行服務器的說明進行操作。