mcp-server-ntopng

by marcoeg

2 212 downloads Not rated yet MIT

GitHub

Other

About

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.

Details

License: MIT

Explore

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mcp-server-ntopng

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

From the repository

1. Create or edit the Claude Desktop configuration file located at:
- On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Add the following:

{
  "mcpServers": {
    "mcp-ntopng": {
      "command": "/path/to/your/uv-binary",
      "args": ["run", "--with", "mcp-ntopng", "--python", "3.13", "mcp-ntopng"]
      "env": {
        "NTOPNG_HOST": "<ntopng-host>",
        "NTOPNG_DBPORT": "<ntopng-dbport>",
        "NTOPNG_DBUSER": "<ntopng-dbuser>",
        "NTOPNG_DBPASSWORD": "<ntopng-dbpassword>",
        "NTOPNG_SECURE": "true",
        "NTOPNG_VERIFY": "true",
        "NTOPNG_CONNECT_TIMEOUT": "30",
        "NTOPNG_SEND_RECEIVE_TIMEOUT": "300",
        "NTOPNG_API_KEY": "NTOPNG_TOKEN"
      }
    }
  }
}

3. Replace /path/to/your/uv-binary with the absolute path to the uv executable. Find the path with which uv. This ensures that the correct version of uv is used when starting the server.

4. Restart Claude Desktop to apply the changes.

The following environment variables are used to configure the database connection:

NTOPNG_HOST: The hostname of the ntopng server
NTOPNG_DBUSER: The username for Clickhouse DB authentication
NTOPNG_DBPASSWORD: The password for Clickhouse DB authentication
NTOPNG_API_KEY: The ntopng authentication token.

`fetch_ntopng_all_ifids`

Retrieve all available interface IDs from ntopng.

`get_ntopng_hosts_location`

Fetch geographical location and additional info for hosts.

`fetch_ntopng_top_local_talkers`

Retrieve the top 10 local talkers for a specified interface.

`fetch_ntopng_top_remote_talkers`

Retrieve the top 10 remote talkers for a specified interface.

`get_ntopng_all_alert_stats`

Retrieve statistics for all alerts.

`get_ntopng_flow_alert_stats`

Retrieve statistics for flow alerts.

`get_ntopng_host_alert_stats`

Retrieve statistics for host alerts.

`get_ntopng_interface_alert_stats`

Retrieve statistics for interface alerts.

`get_ntopng_mac_alert_stats`

Retrieve statistics for MAC alerts.

`get_ntopng_network_alert_stats`

Retrieve statistics for network alerts.

`get_ntopng_snmp_device_alert_list`

Retrieve a list of SNMP device alerts.

`get_ntopng_snmp_device_alert_stats`

Retrieve statistics for SNMP device alerts.

`get_ntopng_system_alert_stats`

Retrieve statistics for system alerts.

`query_ntopng_flows_data`

Retrieve detailed flows data from the ntopng flows database.

`get_ntopng_top-k_flows`

Retrieve top-k flows data from the ntopng flows database.

`get_ntopng_user_alert_stats`

Retrieve statistics for user alerts.

`get_ntopng_flow_devices_stats`

Retrieve statistics for all flow dev`ices.

`get_ntopng_sflow_devices_stats`

Retrieve statistics for all sFlow devices.

`list_tables_ntopng_database`

List tables structure of the ntopng database.

`query_ntopng_database`

Query the ntopng Clickhouse database.

fetch_ntopng_all_ifids
- Retrieve all available interface IDs from ntopng.
get_ntopng_hosts_location
- Fetch geographical location and additional info for hosts.
fetch_ntopng_top_local_talkers
- Retrieve the top 10 local talkers for a specified interface.
fetch_ntopng_top_remote_talkers
- Retrieve the top 10 remote talkers for a specified interface.
get_ntopng_all_alert_stats
- Retrieve statistics for all alerts.
get_ntopng_flow_alert_stats
- Retrieve statistics for flow alerts.
get_ntopng_host_alert_stats
- Retrieve statistics for host alerts.
get_ntopng_interface_alert_stats
- Retrieve statistics for interface alerts.
get_ntopng_mac_alert_stats
- Retrieve statistics for MAC alerts.
get_ntopng_network_alert_stats
- Retrieve statistics for network alerts.
get_ntopng_snmp_device_alert_list
- Retrieve a list of SNMP device alerts.
get_ntopng_snmp_device_alert_stats
- Retrieve statistics for SNMP device alerts.
get_ntopng_system_alert_stats
- Retrieve statistics for system alerts.
query_ntopng_flows_data
- Retrieve detailed flows data from the ntopng flows database.
get_ntopng_top-k_flows
- Retrieve top-k flows data from the ntopng flows database.
get_ntopng_user_alert_stats
- Retrieve statistics for user alerts.
get_ntopng_flow_devices_stats
- Retrieve statistics for all flow devices. get_ntopng_sflow_devices_stats- Retrieve statistics for all sFlow devices.list_tables_ntopng_database- List tables structure of the ntopng database. query_ntopng_database`
- Query the ntopng Clickhouse database.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-server-ntopng": {
            "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"
                }
            }
        }
    }
}

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"
        }
    }
}

NTOPNG Model Context Protocol Server

A Model Context Protocol server implementation for NTOPNG that enables AI agents to query networks monitoring data using the NTOPNG database.

This MCP Server assumes that ntopng is using ClickHouse to store historical flows and alert. Check ntopng Clickhouse

Tools


Status
Works with Claude Desktop app and other MCP compliant hosts and clients.
No support for MCP resources or prompts yet.
Configuration

1. Create or edit the Claude Desktop configuration file located at: - On macOS:~/Library/Application Support/Claude/claude_desktop_config.json- On Windows:%APPDATA%/Claude/claude_desktop_config.json


2. Add the following:
{
  "mcpServers": {
    "mcp-ntopng": {
      "command": "/path/to/your/uv-binary",
      "args": ["run", "--with", "mcp-ntopng", "--python", "3.13", "mcp-ntopng"]
      "env": {
        "NTOPNG_HOST": "<ntopng-host>",
        "NTOPNG_DBPORT": "<ntopng-dbport>",
        "NTOPNG_DBUSER": "<ntopng-dbuser>",
        "NTOPNG_DBPASSWORD": "<ntopng-dbpassword>",
        "NTOPNG_SECURE": "true",
        "NTOPNG_VERIFY": "true",
        "NTOPNG_CONNECT_TIMEOUT": "30",
        "NTOPNG_SEND_RECEIVE_TIMEOUT": "300",
        "NTOPNG_API_KEY": "NTOPNG_TOKEN"
      }
    }
  }
}

3. Replace /path/to/your/uv-binary with the absolute path to the uv executable. Find the path with which uv. This ensures that the correct version of uv is used when starting the server.


4. Restart Claude Desktop to apply the changes.
Development

1. Set the environmental variables either in the claude_desktop_config.json file or in a .env file in the root of the repository.


NTOPNG_HOST=localhost
NTOPNG_PORT=9000
NTOPNG_USER=default
NTOPNG_PASSWORD=

3. Run uv sync to install the dependencies. To install uv follow the instructions here. Then do source .venv/bin/activate.

4. Install the mcp-ntopng package with uv pip install -e . from the project main directory.

4. For easy testing, you can run mcp dev mcp_ntopng/mcp_server.py to start the MCP server. CHANGE WITH A PROPER CHAT CLIENT


Environment Variables
The following environment variables are used to configure the database connection:

NTOPNG_HOST: The hostname of the ntopngserver NTOPNG_DBUSER: The username for Clickhouse DB authenticationNTOPNG_DBPASSWORD: The password for Clickhouse DB authentication NTOPNG_API_KEY: The ntopng authentication token.


Optional

NTOPNG_DBPORT: The port number of the Clickhouse DB in the ntopngserver - Default:9000 if HTTPS is enabled, 8123if disabled - Usually doesn't need to be set unless using a non-standard port NTOPNG_SECURE

: Enable/disable a TLS connection
  - Default:

false


  - Set to

true

 for a secure TLS connections

NTOPNG_VERIFY: Enable/disable SSL certificate verification - Default:true- Set tofalse to disable certificate verification (not recommended for production) NTOPNG_CONNECT_TIMEOUT: Connection timeout in seconds - Default:

30
  - Increase this value if you experience connection timeouts

NTOPNG_SEND_RECEIVE_TIMEOUT: Send/receive timeout in seconds

- Default: 300


  - Increase this value for long-running queries

> Check TLS Setup in the ntopng` documentation for details about setting up a TLS connection to Clickhouse.

Development

Install the package on the local machine:

$ uv sync
$ uv pip install -e .

Run the MCP Inspector

$ cd mcp_ntopng
$ source .env
$ CLIENT_PORT=8077 SERVER_PORT=8078  mcp dev run_mcp_ntopng.py --with clickhouse-driver --with python-dotenv --with uvicorn --with pip-system-certs

Use the local library in Claude Desktop.

Find: /Users/marco/Library/Application\ Support/Claude/claude_desktop_config.json

Edit the claude_desktop_config.json changing the local paths:

{

    "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"

        }

      }

    }

  }

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

fetch_ntopng_all_ifids

get_ntopng_hosts_location

fetch_ntopng_top_local_talkers

fetch_ntopng_top_remote_talkers

get_ntopng_all_alert_stats

get_ntopng_flow_alert_stats

get_ntopng_host_alert_stats

get_ntopng_interface_alert_stats

get_ntopng_mac_alert_stats

get_ntopng_network_alert_stats

get_ntopng_snmp_device_alert_list

get_ntopng_snmp_device_alert_stats

get_ntopng_system_alert_stats

query_ntopng_flows_data

get_ntopng_top-k_flows

get_ntopng_user_alert_stats

get_ntopng_flow_devices_stats

get_ntopng_sflow_devices_stats

list_tables_ntopng_database

query_ntopng_database

Claude Desktop / Cursor

McpServers

Tools

Status

Configuration

Development

Environment Variables

Optional

Development

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

`fetch_ntopng_all_ifids`

`get_ntopng_hosts_location`

`fetch_ntopng_top_local_talkers`

`fetch_ntopng_top_remote_talkers`

`get_ntopng_all_alert_stats`

`get_ntopng_flow_alert_stats`

`get_ntopng_host_alert_stats`

`get_ntopng_interface_alert_stats`

`get_ntopng_mac_alert_stats`

`get_ntopng_network_alert_stats`

`get_ntopng_snmp_device_alert_list`

`get_ntopng_snmp_device_alert_stats`

`get_ntopng_system_alert_stats`

`query_ntopng_flows_data`

`get_ntopng_top-k_flows`

`get_ntopng_user_alert_stats`

`get_ntopng_flow_devices_stats`

`get_ntopng_sflow_devices_stats`

`list_tables_ntopng_database`

`query_ntopng_database`