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リソースまたはプロンプトはまだサポートされていません。

構成

1. 次の場所にある Claude Desktop 構成ファイルを作成または編集します。

   • macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows の場合: %APPDATA%/Claude/claude_desktop_config.json

2. 以下を追加します。

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

4. 変更を適用するには、Claude Desktop を再起動します。

発達

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

3. uv syncを実行して依存関係をインストールします。uvをインストールするにはuvこちらの手順に従ってください。その後、 source .venv/bin/activate実行してください。

4. プロジェクトのメイン ディレクトリからuv pip install -e .を使用してmcp-ntopngパッケージをインストールします。

5. 簡単なテストとして、 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 設定を確認してください。

発達

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

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

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

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

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