mcp-server-ntopng

Name: mcp-server-ntopng
Author: marcoeg

@marcoeg

Repository

About mcp-server-ntopng

ntopng Model Context Protocol Server

Basic information

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?

mcp-server-ntopng is a Model Context Protocol (MCP) server implementation for NTOPNG that enables AI agents to query network monitoring data using the NTOPNG database. It assumes ntopng uses ClickHouse to store historical flows and alerts.

How to use mcp-server-ntopng?

Configure the server by adding an entry to your Claude Desktop configuration file (claude_desktop_config.json) with the path to the uv binary and required environment variables (NTOPNG_HOST, NTOPNG_DBUSER, NTOPNG_DBPASSWORD, NTOPNG_API_KEY, etc.). After restarting Claude Desktop, the server’s tools become available for querying network data.

Key features of mcp-server-ntopng

20 tools for querying ntopng network monitoring data
Retrieve interface IDs, host locations, and top talkers
Fetch alert statistics for flows, hosts, interfaces, MACs, networks, SNMP devices, and users
Query detailed flows data and top‑k flows
List database tables and run arbitrary ClickHouse queries
Works with Claude Desktop and other MCP‑compliant hosts

Use cases of mcp-server-ntopng

AI‑assisted network troubleshooting by querying live alert statistics
Automated reporting of top local and remote talkers per interface
Forensic analysis of historical flows and SNMP device alerts
Custom database queries for deep network monitoring insights

FAQ from mcp-server-ntopng

What prerequisites does mcp-server-ntopng require?

The server requires ntopng to be configured with ClickHouse for flow and alert storage. It also needs Python 3.13 and the uv package manager.

How do I configure mcp-server-ntopng?

Set environment variables in the Claude Desktop config file: NTOPNG_HOST, NTOPNG_DBUSER, NTOPNG_DBPASSWORD, NTOPNG_API_KEY, and optionally NTOPNG_DBPORT, NTOPNG_SECURE, NTOPNG_VERIFY, NTOPNG_CONNECT_TIMEOUT, NTOPNG_SEND_RECEIVE_TIMEOUT.

Does mcp-server-ntopng support MCP resources or prompts?

No, the server currently only provides tools. Support for resources and prompts is not yet implemented.

What transport does mcp-server-ntopng use?

The server uses the standard MCP stdio transport, launched via the uv command in the Claude Desktop configuration.

How does authentication work?

Authentication is handled via the NTOPNG_API_KEY environment variable (the ntopng authentication token) and ClickHouse database credentials (NTOPNG_DBUSER, NTOPNG_DBPASSWORD).

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K