mcp-ntopng

一个用于网络监控软件 ntopng 的 MCP 服务器

轻量版

开发

环境配置

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。

可以在 MCP Inspector 中自由切换 stdio 和 sse 传输类型。要使用 sse，请按照以下说明运行服务器。

运行服务器：

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

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

• 默认在端口 9090 上使用 SSE 传输运行。

在运行服务器的终端中，会显示所有活动的完整日志。这对于调试非常有用。