mcp-server-ntopng

NTOPNG モデルコンテキストプロトコルサーバー

AI エージェントが NTOPNG データベースを使用してネットワーク監視データを照会できるようにする、 NTOPNG用のモデルコンテキストプロトコルサーバー実装。

このMCPサーバーは、 ntopngがClickHouseを使用して履歴フローとアラートを保存することを前提としています。ntopng Clickhouseを確認してください。

ツール

fetch_ntopng_all_ifids
ntopng から利用可能なすべてのインターフェース ID を取得します。
get_ntopng_hosts_location
ホストの地理的位置と追加情報を取得します。
fetch_ntopng_top_local_talkers
指定されたインターフェースの上位 10 件のローカルトーカーを取得します。
fetch_ntopng_top_remote_talkers
指定されたインターフェースの上位 10 件のリモートトーカーを取得します。
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
MAC アラートの統計を取得します。
get_ntopng_network_alert_stats
ネットワークアラートの統計を取得します。
get_ntopng_snmp_device_alert_list
SNMP デバイスアラートのリストを取得します。
get_ntopng_snmp_device_alert_stats
SNMP デバイスアラートの統計を取得します。
get_ntopng_system_alert_stats
システムアラートの統計を取得します。
query_ntopng_flows_data
ntopng フローデータベースから詳細なフローデータを取得します。
get_ntopng_top-k_flows
ntopng フローデータベースからトップ k フローデータを取得します。
get_ntopng_user_alert_stats
ユーザーアラートの統計を取得します。
get_ntopng_flow_devices_stats
すべてのフローデバイスの統計を取得します。
get_ntopng_sflow_devices_stats
すべての sFlow デバイスの統計を取得します。
list_tables_ntopng_database
ntopng データベースのテーブル構造を一覧表示します。
query_ntopng_database
ntopng Clickhouse データベースをクエリします。

状態

Claude デスクトップアプリおよびその他の MCP 準拠のホストおよびクライアントで動作します。

MCPリソースまたはプロンプトはまだサポートされていません。

構成

次の場所にある Claude Desktop 構成ファイルを作成または編集します。
- macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
以下を追加します。

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

/path/to/your/uv-binaryをuv実行ファイルへの絶対パスに置き換えます。 which uvパスを確認してください。これにより、サーバーの起動時に正しいバージョンのuvが使用されるようになります。
変更を適用するには、Claude Desktop を再起動します。

発達

環境変数は、 claude_desktop_config.jsonファイルまたはリポジトリのルートにある.envファイルのいずれかで設定します。

NTOPNG_HOST=localhost
NTOPNG_PORT=9000
NTOPNG_USER=default
NTOPNG_PASSWORD=

uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。
プロジェクトのメインディレクトリからuv pip install -e .を使用してmcp-ntopngパッケージをインストールします。
簡単なテストとして、 mcp dev mcp_ntopng/mcp_server.pyを実行してMCPサーバーを起動できます。適切なチャットクライアントに変更してください。

環境変数

データベース接続を構成するには、次の環境変数が使用されます。

NTOPNG_HOST : ntopngサーバーのホスト名
NTOPNG_DBUSER : Clickhouse DB認証のユーザー名
NTOPNG_DBPASSWORD : Clickhouse DB認証のパスワード
NTOPNG_API_KEY : ntopng認証トークン。

オプション

NTOPNG_DBPORT : ntopngサーバのClickhouse DBのポート番号
- デフォルト: HTTPS が有効な場合は9000 、無効な場合は8123
- 非標準ポートを使用しない限り、通常は設定する必要はありません
NTOPNG_SECURE : TLS接続を有効/無効にする
- デフォルト: false
- 安全なTLS接続の場合はtrueに設定
NTOPNG_VERIFY : SSL証明書の検証を有効/無効にする
- デフォルト: true
- 証明書の検証を無効にするには `false に設定します（本番環境では推奨されません）
NTOPNG_CONNECT_TIMEOUT : 接続タイムアウト（秒）
- デフォルト: `30
- 接続タイムアウトが発生する場合はこの値を増やしてください
NTOPNG_SEND_RECEIVE_TIMEOUT : 送受信タイムアウト（秒）
- デフォルト: 300
- 長時間実行されるクエリの場合はこの値を増やします

Clickhouse への TLS 接続の設定の詳細については、 ntopngドキュメントのTLS 設定を確認してください。

発達

ローカルマシンにパッケージをインストールします。

$ uv sync
$ uv pip install -e .

MCPインスペクターを実行する

$ 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

Claude Desktop のローカルライブラリを使用します。

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

claude_desktop_config.json を編集してローカルパスを変更します。

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

mcp-ntopng

Integrations

mcp-server-ntopng

ツール

状態

構成

発達

環境変数

オプション

発達

Related Resources