Wazuh MCP Server

🚀 Wazuh MCP サーバー

このサービスは、WazuhのセキュリティデータをClaude Desktop Appなどの大規模言語モデルと統合するための、本番環境向けのオープンソースMCPサーバーです。このサービスは、REST APIを介してJWTトークンを使用してWazuhと認証し、Elasticsearchインデックスからアラートを取得し、イベントをMCP標準のJSON形式に変換し、Claude Desktopがリアルタイムでセキュリティコンテキストを取得できるHTTPエンドポイントを公開します。

✨ 主な機能

• JWTベースの認証: JWTトークンを使用して、Wazuhと安全に認証します。
• アラートの取得: Elasticsearchインデックスをクエリして、Wazuhのアラートデータを取得します。
• MCPメッセージの変換: セキュリティイベントを標準化されたMCPメッセージに変換します。
• Flask HTTPサーバー: Claude Desktopとの統合に使用する/mcpエンドポイントを提供します。
• 強力なエラー処理: トークンの有効期限切れ、ネットワークのタイムアウト、および形式が誤ったデータを処理します。
• 設定の柔軟性: 環境変数を使用して簡単に設定でき、Claude Desktopの設定ファイルを介して統合できます。

📦 インストール

前提条件

• Python 3.8以上
• Wazuh APIインスタンスへのアクセス権
• （オプション）MCPサーバーを呼び出すために設定済みのClaude Desktop

インストール手順

1. リポジトリをクローンする:

   git clone https://github.com/unmuktoai/Wazuh-MCP-Server.git
   cd Wazuh-MCP-Server
   

2. 仮想環境を作成してアクティブ化する:

   python3 -m venv venv
   source venv/bin/activate  # Windowsユーザーは venv\Scripts\activate を使用してください
   

3. 依存関係をインストールする:

   pip install -r requirements.txt
   

4. 設定する MCPサーバーを設定するには、以下の環境変数を設定します。

   WAZUH_HOST: Wazuhサーバーのホスト名またはIPアドレスを指定します。
   WAZUH_PORT: Wazuh APIが使用するポート（デフォルト: 55000）。
   WAZUH_USER: Wazuh APIのユーザー名。
   WAZUH_PASS: Wazuh APIのパスワード。
   VERIFY_SSL: "true"または"false"に設定します（デフォルト: false）。
   MCP_SERVER_PORT: MCPサーバーが動作するポート（デフォルト: 8000）。
   

   例（MacOS）:

   export WAZUH_HOST="your_wazuh_server"
   export WAZUH_PORT="55000"
   export WAZUH_USER="your_username"
   export WAZUH_PASS="your_password"
   export VERIFY_SSL="false"
   export MCP_SERVER_PORT="8000"
   

5. サーバーを起動する 以下のコマンドを使用してMCPサーバーを起動します。

   python wazuh_mcp_server.py 
   

   サーバーは指定されたMCP_SERVER_PORTですべてのインターフェースをリッスンします。
6. Claude Desktopとの統合 MCPサーバーをClaude Desktopと統合するには、設定ファイルを更新します。 MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json mcpServersの下に以下のエントリを追加します。

   {
     "mcpServers": {
       "mcp-server-wazuh": {
         "command": "python3 /path/to/Wazuh-MCP-Server/wazuh_mcp_server.py",
         "env": {
           "WAZUH_HOST": "your_wazuh_server",
           "WAZUH_PORT": "55000",
           "WAZUH_USER": "your_username",
           "WAZUH_PASS": "your_password",
           "MCP_SERVER_PORT": "8000",
           "VERIFY_SSL": "false"
         }
       }
     }
   }
   

📄 ライセンス

このプロジェクトはMITライセンスの下でオープンソースとして公開されています。