Wazuh

🚀 Wazuh MCP 服務器

這是一個生產級的開源 MCP 服務器，主要用於將 Wazuh 安全數據與大型語言模型（如 Claude Desktop App）進行集成。該服務藉助 JWT 身份驗證與 Wazuh RESTful API 通信，從 Elasticsearch 索引中檢索警報，把事件轉化為符合 MCP 標準的 JSON 格式，並且提供一個 HTTP 端點，方便 Claude Desktop 即時獲取安全上下文。

🚀 快速開始

此 MCP 服務器能有效簡化 Wazuh 與現代語言模型的集成，提升安全分析能力。你可按以下步驟完成安裝與配置。

✨ 主要特性

• 基於 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. 運行服務器

   python wazuh_mcp_server.py
   

服務器將在指定的MCP_SERVER_PORT端口上監聽所有接口。 6. 與 Claude Desktop 集成 要與 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"
      }
    }
  }
}

📄 許可證

[項目許可證信息]

🤝 貢獻指南

歡迎為該項目做出貢獻！請參考[貢獻指南]瞭解如何參與。