AI导哈

网络监控数据查询服务

一个基于Model Context Protocol的服务器实现，用于通过NTOPNG数据库查询网络监控数据，支持AI代理访问网络流量和警报信息。

  • by marcoeg
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 marcoeg/mcp-server-ntopng

使用说明

mcp服务器ntopng

NTOPNG模型上下文协议服务器

A. 模型上下文协议 服务器实现 NTOPNG 这使得AI代理能够使用NTOPNG数据库查询网络监控数据。

此MCP服务器假定 ntopng 正在使用ClickHouse存储历史流量和警报。检查 ntopng Clickhouse

工具

  • fetch_ntopng_all_ifids
  • 从ntopng中检索所有可用的接口ID。
  • get_ntopng_hosts_location
  • 获取主机的地理位置和其他信息。
  • fetch_ntopng_top_local_talkers
  • 检索指定接口的前10个本地讲话者。
  • fetch_ntopng_top_remote_talkers
  • 检索指定接口的前10个远程讲话者。
  • get_ntopng_all_alert_stats
  • 检索所有警报的统计信息。
  • get_ntopng_flow_alert_stats
  • 检索流量警报的统计信息。
  • get_ntopng_host_alert_stats
  • 检索主机警报的统计信息。
  • get_ntopng_interface_alert_stats
  • 检索接口警报的统计信息。
  • get_ntopng_mac_alert_stats
  • 检索MAC警报的统计信息。
  • get_ntopng_network_alert_stats
  • 检索网络警报的统计信息。
  • get_ntopng_snmp_device_alert_list
  • 检索SNMP设备警报列表。
  • get_ntopng_snmp_device_alert_stats
  • 检索SNMP设备警报的统计信息。
  • get_ntopng_system_alert_stats
  • 检索系统警报的统计信息。
  • query_ntopng_flows_data
  • 从ntopng流数据库中检索详细的流数据。
  • get_ntopng_top-k_flows
  • 从ntopng流数据库中检索top-k流数据。
  • get_ntopng_user_alert_stats
  • 检索用户警报的统计信息。
  • get_ntopng_flow_devices_stats
  • 检索所有流量设备的统计数据。
  • get_ntopng_sflow_devices_stats
  • 检索所有sFlow设备的统计信息。
  • list_tables_ntopng_database
  • 列出ntopng数据库的表结构。
  • query_ntopng_database
  • 查询ntopng Clickhouse数据库。

状态

适用于Claude Desktop应用程序和其他符合MCP标准的主机和客户端。

不支持MCP 资源 或 鼓励 然而。

配置

  1. 创建或编辑位于以下位置的Claude Desktop配置文件：

    • 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

  2. 添加以下内容：

{
  "mcpServers": {
    "mcp-ntopng": {
      "command": "/path/to/your/uv-binary",
      "args": ["run", "--with", "mcp-ntopng", "--python", "3.13", "mcp-ntopng"]
      "env": {
        "NTOPNG_HOST": "<ntopng-host>",
        "NTOPNG_DBPORT": "<ntopng-dbport>",
        "NTOPNG_DBUSER": "<ntopng-dbuser>",
        "NTOPNG_DBPASSWORD": "<ntopng-dbpassword>",
        "NTOPNG_SECURE": "true",
        "NTOPNG_VERIFY": "true",
        "NTOPNG_CONNECT_TIMEOUT": "30",
        "NTOPNG_SEND_RECEIVE_TIMEOUT": "300",
        "NTOPNG_API_KEY": "NTOPNG_TOKEN"
      }
    }
  }
}

  1. 替换 /path/to/your/uv-binary 通过绝对路径 uv 可执行。找到路径 which uv这确保了正确的版本 uv 启动服务器时使用。

  2. 重新启动Claude Desktop以应用更改。

发展

  1. 在以下任一位置设置环境变量 claude_desktop_config.json 文件或 .env 存储库根目录中的文件。
NTOPNG_HOST=localhost
NTOPNG_PORT=9000
NTOPNG_USER=default
NTOPNG_PASSWORD=

  1. 跑 uv sync 安装依赖项。安装 uv 按照说明 这里。那就去吧 source .venv/bin/activate.

  2. 安装 mcp-ntopng 包装带 uv pip install -e . 从项目主目录。

  3. 为了便于测试，您可以运行 mcp dev mcp_ntopng/mcp_server.py 启动MCP服务器。 使用合适的聊天客户端进行更改

环境变量

以下环境变量用于配置数据库连接：

  • NTOPNG_HOST：主机名 ntopng 服务器
  • NTOPNG_DBUSER：Clickhouse DB身份验证的用户名
  • NTOPNG_DBPASSWORD：Clickhouse DB身份验证的密码
  • NTOPNG_API_KEY：The ntopng 身份验证令牌。

可选的

  • NTOPNG_DBPORT：Clickhouse数据库的端口号 ntopng 服务器
    • 违约： 9000 如果启用了HTTPS， 8123 如果禁用
    • 通常不需要设置，除非使用非标准端口
  • NTOPNG_SECURE：启用/禁用TLS连接
    • 违约： false
    • 吃起来 true 用于安全的TLS连接
  • NTOPNG_VERIFY：启用/禁用SSL证书验证
    • 违约： true
    • 设置为`false以禁用证书验证（不建议用于生产）
  • NTOPNG_CONNECT_TIMEOUT：连接超时（秒）
    • 默认值：`30
    • 如果遇到连接超时，请增加此值
  • NTOPNG_SEND_RECEIVE_TIMEOUT：发送/接收超时（秒）
    • 违约： 300
    • 为长时间运行的查询增加此值

检查 TLS设置 在 ntopng 有关设置到Clickhouse的TLS连接的详细信息的文档。

发展

在本地计算机上安装软件包：

$ uv sync
$ uv pip install -e .

运行MCP检查器

$ cd mcp_ntopng
$ source .env
$ 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中的本地库。

查找：/用户/marco/库/应用程序\支持/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",
          "NTOPNG_CONNECT_TIMEOUT": "30",
          "NTOPNG_SEND_RECEIVE_TIMEOUT": "300",
          "SELECT_QUERY_TIMEOUT_SECS": "30",
          "NTOPNG_API_KEY": "NTOPNG_TOKEN"
        }
      }
    }
  }

相关 MCP