mcp-ntopng
About
An MCP server for network monitoring software ntopng
Details
- Author
- marcoeg
- Downloads
- 209
- Categories
- Other
Jump to
- 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
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-ntopngCommand (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
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-ntopng": {
"mcp-ntopng": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"mcp-ntopng": {
"command": "uv",
"args": [
"sync"
]
}
}mcp-ntopng
An MCP server for network monitoring software ntopng>Lite version
Development
Setup
1. Prerequisites:
- Python 3.13 or higher.
- uv package manager (installation).
2. Clone the Repository:
git clone https://github.com/marcoeg/mcp-nvd
cd mcp-nvd
3. Set Environment Variables:
- Create a .env file in the project root with the mandatory environmental variables:
NTOPNG_HOST=localhost
NTOPNG_PORT=9000
NTOPNG_USER=default
NTOPNG_PASSWORD=
4. Install Dependencies:
uv sync
uv pip install -e .
Run with the MCP Inspector
cd /path/to/the/repo
source .env
CLIENT_PORT=8077 SERVER_PORT=8078 npx @modelcontextprotocol/inspector uv \
--directory /path/to/repo/mcp-ntopng run mcp-ntopng
Then open the browser to the URL indicated by the MCP Inspector, typically http://localhost:8077?proxyPort=8078
After connecting, list the Tools. Select query_ntopng_database and enter in the query a SELECT
statement like SELECT * FROM host_alerts_view LIMIT 2.
> Switch freely between stdio and sse transport types in the inspector. To use sse you need to run the server as explained below.
Run the Server:
cd /path/to/the/repo
source .env
uv run mcp-ntopng --transport sse --port 9090
- Runs with SSE transport on port
9090 by default.
>In the terminal running the server there is a full log of the activities. Very useful for debugging.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
