Wazuh MCP Server

🚀 Wazuh MCP 服務器

Wazuh MCP 服務器是一個生產級別的開源 MCP 服務器，它能將 Wazuh 安全數據與大型語言模型（如 Claude Desktop App）集成。該服務藉助 JWT 令牌，通過 REST API 與 Wazuh 進行身份驗證，從 Elasticsearch 索引中檢索警報，把事件轉換為符合 MCP 標準的 JSON 格式，還提供一個 HTTP 端點，供 Claude Desktop 即時獲取安全上下文。

✨ 主要特性

• 基於 JWT 的身份驗證：使用 JWT 令牌安全地與 Wazuh 進行身份驗證。
• 警報檢索：查詢 Elasticsearch 索引以獲取 Wazuh 警報數據。
• MCP 消息轉換：將安全事件轉換為標準化的 MCP 消息。
• Flask HTTP 服務器：提供一個 /mcp 端點，用於 Claude Desktop 集成。
• 強大的錯誤處理：處理令牌過期、網絡超時和格式錯誤的數據。
• 可配置性：通過環境變量輕鬆配置，並通過 Claude Desktop 的配置文件進行集成。

📦 安裝指南

先決條件

• Python 3.8+
• 對 Wazuh API 實例的訪問權限
• (可選) 已配置好的 Claude Desktop，以便調用 MCP 服務器

安裝步驟

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 License 下開源。