Advertise
MCP.so
Sign In

MCP Server Ntopng

@MCP-Mirror

Repository

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

MCP-Mirror

About MCP Server Ntopng

Mirror of

#mcp-server#ntopng#network-monitoring

MCP Server Ntopng 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"
      }
    }
  }
}

MCP Server Ntopng tools

20

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.

Frequently asked questions

1

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.

2

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`.

3

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.

4

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.

5

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

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

MCP Toolbox for Databases

googleapis

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

15.9K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K
Advertise