Advertise
MCP.so
Sign In

MCP Server Ntopng

@marcoeg

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

marcoeg

Submitted by

Marco Graziano

About MCP Server Ntopng

ntopng Model Context Protocol Server

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?

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

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

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

MCP Toolbox for Databases

googleapis

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

15.9K

Codelf

unbug

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

14.2K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Advertise