mcp-ntopng

What is mcp-ntopng?

mcp-ntopng is an MCP (Model Context Protocol) server that provides a tool to run SQL SELECT queries on the internal database of the network monitoring software ntopng. It is intended for developers and network administrators who want to interact with ntopng data programmatically via AI assistants or the MCP Inspector.

How to use mcp-ntopng?

Clone the repository, set the required environment variables (NTOPNG_HOST, NTOPNG_PORT, NTOPNG_USER, NTOPNG_PASSWORD) in a .env file, and install dependencies with uv sync. Run the server using uv run mcp-ntopng --transport sse --port 9090 (or omit flags for stdio). Use the MCP Inspector to list the query_ntopng_database tool and submit SELECT statements.

Key features of mcp-ntopng

• Tool query_ntopng_database for SQL SELECT on ntopng’s database
• Supports both stdio and SSE transport modes
• Requires Python 3.13+, uv package manager, and a running ntopng instance

Use cases of mcp-ntopng

• Querying ntopng’s host_alerts_view to inspect recent network alerts
• Integrating ntopng data with MCP‑enabled AI assistants for network analysis
• Automated monitoring workflows via the MCP Inspector or custom clients

FAQ from mcp-ntopng

What is a “Lite version”?

The README labels this version as “Lite”, implying a simplified or reduced feature set compared to a full version, but no further details are given.

What environment variables are required?

You must set NTOPNG_HOST, NTOPNG_PORT, NTOPNG_USER, and NTOPNG_PASSWORD in a .env file before running the server.

Which transports are supported?

The server can be run with stdio (default) or SSE (by passing --transport sse). When using SSE, the default port is 9090 and can be changed with --port.

How do I test the server?

Use the MCP Inspector: set source .env, then run the inspector command provided in the README. After connecting, list the tools, choose query_ntopng_database, and enter a SELECT statement (e.g., SELECT * FROM host_alerts_view LIMIT 2).

What programming language / runtime does it need?

The server is written in Python and requires Python 3.13 or higher along with the uv package manager.