MCP Ntopng

🚀 mcp-ntopng

ネットワーク監視ソフトウェア ntopng 用の MCP サーバーです。

軽量版

🚀 クイックスタート

📦 インストール

環境構成

1. 前提条件：

   • Python 3.13 以上のバージョン。
   • uv パッケージ管理ツール（インストール方法）。

2. リポジトリのクローン：

git clone https://github.com/marcoeg/mcp-nvd
cd mcp-nvd

3. 環境変数の設定：

   • プロジェクトのルートディレクトリに .env ファイルを作成し、必要な環境変数を追加します。

   NTOPNG_HOST=localhost NTOPNG_PORT=9000 NTOPNG_USER=default NTOPNG_PASSWORD=

4. 依存関係のインストール：

uv sync
uv pip install -e .

💻 使用例

基本的な使用法

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

その後、ブラウザで MCP Inspector が指定する URL（通常は http://localhost:8077?proxyPort=8078）を開きます。

接続後、ツールを一覧表示します。query_ntopng_database を選択し、SELECT * FROM host_alerts_view LIMIT 2 のような SELECT 文を入力します。

MCP Inspector では stdio と sse の伝送タイプを自由に切り替えることができます。sse を使用する場合は、以下の手順でサーバーを実行してください。

高度な使用法

サーバーの実行

cd /path/to/the/repo
source .env

uv run mcp-ntopng --transport sse --port 9090

• デフォルトではポート 9090 で SSE 伝送を使用して実行されます。

サーバーを実行しているターミナルには、すべてのアクティビティの完全なログが表示されます。これはデバッグに非常に役立ちます。