🚀 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"
      }
    }
  }
}

📄 许可证

[项目许可证信息]

🤝 贡献指南

欢迎为该项目做出贡献！请参考[贡献指南]了解如何参与。