mcp-server-ntopng
@marcoeg
About mcp-server-ntopng
ntopng Model Context Protocol Server
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
20Retrieve 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).
Frequently asked questions
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).
Basic information
More Other MCP servers
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
Peekaboo MCP – lightning-fast macOS screenshots for AI agents
steipetePeekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.
Inbox Zero AI MCP
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Awesome Mlops
visengerA curated list of references for MLOps
ghidraMCP
LaurieWiredMCP Server for Ghidra
Comments