🚀 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，请按照上述运行服务器的说明进行操作。