mcp-server-ntopng

@MCP-Mirror

About mcp-server-ntopng

Mirror of

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

Tools

Retrieve all available interface IDs from ntopng.

Fetch geographical location and additional info for hosts.

Retrieve the top 10 local talkers for a specified interface.

Retrieve the top 10 remote talkers for a specified interface.

Retrieve statistics for all alerts.

Retrieve statistics for flow alerts.

Retrieve statistics for host alerts.

Retrieve statistics for interface alerts.

Retrieve statistics for MAC alerts.

Retrieve statistics for network alerts.

Retrieve a list of SNMP device alerts.

Retrieve statistics for SNMP device alerts.

Retrieve statistics for system alerts.

Retrieve detailed flows data from the ntopng flows database.

Retrieve top-k flows data from the ntopng flows database.

Retrieve statistics for user alerts.

Retrieve statistics for all flow dev`ices.

Retrieve statistics for all sFlow devices.

List tables structure of the ntopng database.

Query the ntopng Clickhouse database.

Overview

What is mcp-server-ntopng?

A Model Context Protocol server that enables AI agents to query network monitoring data from NTOPNG via its ClickHouse database. It is designed for users of NTOPNG and MCP-compliant hosts like Claude Desktop.

How to use mcp-server-ntopng?

Configure the MCP server in a Claude Desktop configuration file by specifying the uv command, environment variables for database connection (NTOPNG_HOST, NTOPNG_DBUSER, NTOPNG_DBPASSWORD, NTOPNG_API_KEY), and optional TLS/timeout settings. Install dependencies with uv sync and start the server with an MCP host.

Key features of mcp-server-ntopng

Retrieve all available interface IDs from ntopng.
Fetch geographical location and info for hosts.
Get top 10 local and remote talkers per interface.
Retrieve statistics for various alert types (flow, host, interface, etc.).
Query detailed flows data and top-k flows.
List and query the ntopng ClickHouse database.

Use cases of mcp-server-ntopng

Monitor network traffic by querying top talkers and interface activity.
Analyze security events by retrieving alert statistics for different categories.
Investigate historical flows with detailed flow data queries.
Obtain host location and metadata for network mapping.
Run ad‑hoc SQL queries against the ntopng ClickHouse database.

FAQ from mcp-server-ntopng

What are the prerequisites for using mcp-server-ntopng?

The server assumes ntopng is configured to use ClickHouse for storing historical flows and alerts. A running ntopng instance with an accessible ClickHouse database is required.

What environment variables must be set?

Required variables: NTOPNG_HOST, NTOPNG_DBUSER, NTOPNG_DBPASSWORD, and NTOPNG_API_KEY. Optional variables include NTOPNG_DBPORT, NTOPNG_SECURE, NTOPNG_VERIFY, NTOPNG_CONNECT_TIMEOUT, and NTOPNG_SEND_RECEIVE_TIMEOUT.

Does mcp-server-ntopng work with any MCP client?

Yes, it works with Claude Desktop and other MCP‑compliant hosts and clients. It does not yet support MCP resources or prompts.

How can TLS be enabled for the ClickHouse connection?

Set NTOPNG_SECURE to true and configure NTOPNG_VERIFY for certificate validation. Consult the ntopng TLS setup documentation for details.

Where does the server run and how is authentication handled?

The server runs locally on the machine hosting the MCP client. Authentication to ntopng is done via an API key (NTOPNG_API_KEY), and credentials for the ClickHouse database are provided through environment variables.

Frequently asked questions

What are the prerequisites for using mcp-server-ntopng?

The server assumes ntopng is configured to use ClickHouse for storing historical flows and alerts. A running ntopng instance with an accessible ClickHouse database is required.

What environment variables must be set?

Required variables: `NTOPNG_HOST`, `NTOPNG_DBUSER`, `NTOPNG_DBPASSWORD`, and `NTOPNG_API_KEY`. Optional variables include `NTOPNG_DBPORT`, `NTOPNG_SECURE`, `NTOPNG_VERIFY`, `NTOPNG_CONNECT_TIMEOUT`, and `NTOPNG_SEND_RECEIVE_TIMEOUT`.

Does mcp-server-ntopng work with any MCP client?

Yes, it works with Claude Desktop and other MCP‑compliant hosts and clients. It does not yet support MCP resources or prompts.

How can TLS be enabled for the ClickHouse connection?

Set `NTOPNG_SECURE` to `true` and configure `NTOPNG_VERIFY` for certificate validation. Consult the ntopng TLS setup documentation for details.

Where does the server run and how is authentication handled?

The server runs locally on the machine hosting the MCP client. Authentication to ntopng is done via an API key (`NTOPNG_API_KEY`), and credentials for the ClickHouse database are provided through environment variables.

Comments

Basic information

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

About mcp-server-ntopng

Config

Tools

fetch_ntopng_all_ifids

get_ntopng_hosts_location

fetch_ntopng_top_local_talkers

fetch_ntopng_top_remote_talkers

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

get_ntopng_network_alert_stats

get_ntopng_snmp_device_alert_list

get_ntopng_snmp_device_alert_stats

get_ntopng_system_alert_stats

query_ntopng_flows_data

get_ntopng_top-k_flows

get_ntopng_user_alert_stats

get_ntopng_flow_devices_stats

get_ntopng_sflow_devices_stats

list_tables_ntopng_database

query_ntopng_database

Overview

What is mcp-server-ntopng?

How to use mcp-server-ntopng?

Key features of mcp-server-ntopng

Use cases of mcp-server-ntopng

FAQ from mcp-server-ntopng

What are the prerequisites for using mcp-server-ntopng?

What environment variables must be set?

Does mcp-server-ntopng work with any MCP client?

How can TLS be enabled for the ClickHouse connection?

Where does the server run and how is authentication handled?

Frequently asked questions

What are the prerequisites for using mcp-server-ntopng?

What environment variables must be set?

Does mcp-server-ntopng work with any MCP client?

How can TLS be enabled for the ClickHouse connection?

Where does the server run and how is authentication handled?

Comments

More Other MCP servers

MCP Toolbox for Databases

DeepMark

Glasswarp

MaxKB

Figs, Relationship Expert