MCP Server Ntopng

🚀 mcp-server-ntopng

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

このサーバは、モデルコンテキストプロトコル の実装であり、NTOPNG との接続を可能にします。このプロトコルにより、AI モデルはコンテキストを通じて相互作用することができます。

✨ 主な機能

• 複数のクエリタイプをサポート：リアルタイムデータや履歴データ分析などを含みます。
• 効率的な通信メカニズム：モデルと NTOPNG 間の効率的なデータ交換を保証します。
• 柔軟な設定オプション：環境変数をカスタマイズしてサーバの動作を調整できます。

🚀 クイックスタート

環境変数の設定

以下の環境変数は、データベース接続を設定するために使用されます。

• NTOPNG_HOST：NTOPNG サービスのホスト名
• NTOPNG_DBUSER：ClickHouse データベースの認証ユーザー名
• NTOPNG_DBPASSWORD：ClickHouse データベースの認証パスワード
• NTOPNG_API_KEY：NTOPNG の認証トークン

オプション設定

• NTOPNG_DBPORT：ClickHouse データベースのポート番号。HTTPS が有効な場合はデフォルトで 9000、無効な場合は 8123 です。
• NTOPNG_SECURE：TLS 接続の有効/無効を設定します。デフォルトは false です。
• NTOPNG_VERIFY：SSL 証明書検証の有効/無効を設定します。デフォルトは true です。
• NTOPNG_CONNECT_TIMEOUT：接続タイムアウト時間（秒）。デフォルトは 30 秒です。
• NTOPNG_SEND_RECEIVE_TIMEOUT：送受信タイムアウト時間（秒）。デフォルトは 300 秒です。

インストールと実行

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

   $ uv sync
   

2. パッケージのインストール：

   $ uv pip install -e .
   

3. サーバの起動（サンプル環境変数を使用）：

   $ 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",
          "SELECT_QUERY_TIMEOUT_SECS": "30",
          "NTOPNG_API_KEY": "NTOPNG_TOKEN"
        }
      }
    }
  }

⚠️ 重要提示

上記の設定のパスと値は、実際の状況に合わせて調整してください。