mcp-server-ntopng

Name: mcp-server-ntopng
Author: MCP-Mirror

@MCP-Mirror

リポジトリ

mcp-server-ntopng について

Mirror of

#mcp-server #ntopng #network-monitoring

基本情報

カテゴリ

その他

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

MCP-Mirror

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

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.

概要

What is mcp-server-ntopng?

A Model Context Protocol server that enables AI agents to query network monitoring data from NTOPNG via its ClickHouse database. It is designed for users of NTOPNG and MCP-compliant hosts like Claude Desktop.

How to use mcp-server-ntopng?

Configure the MCP server in a Claude Desktop configuration file by specifying the uv command, environment variables for database connection (NTOPNG_HOST, NTOPNG_DBUSER, NTOPNG_DBPASSWORD, NTOPNG_API_KEY), and optional TLS/timeout settings. Install dependencies with uv sync and start the server with an MCP host.

Key features of mcp-server-ntopng

Retrieve all available interface IDs from ntopng.
Fetch geographical location and info for hosts.
Get top 10 local and remote talkers per interface.
Retrieve statistics for various alert types (flow, host, interface, etc.).
Query detailed flows data and top-k flows.
List and query the ntopng ClickHouse database.

Use cases of mcp-server-ntopng

Monitor network traffic by querying top talkers and interface activity.
Analyze security events by retrieving alert statistics for different categories.
Investigate historical flows with detailed flow data queries.
Obtain host location and metadata for network mapping.
Run ad‑hoc SQL queries against the ntopng ClickHouse database.

FAQ from mcp-server-ntopng

What are the prerequisites for using mcp-server-ntopng?

The server assumes ntopng is configured to use ClickHouse for storing historical flows and alerts. A running ntopng instance with an accessible ClickHouse database is required.

What environment variables must be set?

Required variables: NTOPNG_HOST, NTOPNG_DBUSER, NTOPNG_DBPASSWORD, and NTOPNG_API_KEY. Optional variables include NTOPNG_DBPORT, NTOPNG_SECURE, NTOPNG_VERIFY, NTOPNG_CONNECT_TIMEOUT, and NTOPNG_SEND_RECEIVE_TIMEOUT.

Does mcp-server-ntopng work with any MCP client?

Yes, it works with Claude Desktop and other MCP‑compliant hosts and clients. It does not yet support MCP resources or prompts.

How can TLS be enabled for the ClickHouse connection?

Set NTOPNG_SECURE to true and configure NTOPNG_VERIFY for certificate validation. Consult the ntopng TLS setup documentation for details.

Where does the server run and how is authentication handled?

The server runs locally on the machine hosting the MCP client. Authentication to ntopng is done via an API key (NTOPNG_API_KEY), and credentials for the ClickHouse database are provided through environment variables.