Wazuh SIEM 및 대형 언어 모델 (LLMs)의 원활한 통합을 위해 생산 ready ** Model Context Protocol (MCP) 서버 **.

왜? Wazuh의 포괄적 인 보안 모니터링의 힘을 결합하여 큰 언어 모델의 소싱 기능을 사용하여 보안 데이터의 자연 언어 쿼리 및 지능형 분석.

---

✨ 주요 특징

• ♨Production-ready: Proper 패키지 구조, 로깅, 오류 처리 및 구성 관리
• ☸ Secure: 자동 새로 고침을 가진 JWT 토큰 관리
• Ÿ ** HTTP / 2 지원 ** : 연결 풀링과 현대 동기화 HTTP 클라이언트 내장
• 일반적인 API: Access Wazuh 에이전트, 인증 및 기타
• ️️Configurable: 환경변수, CLI변수, 그리고 정밀한 편두 도구 필터링
• ☸ Pip installable: GitHub 릴리스 또는 소스에서 직접 설치

---

내용 표

• 빠른 시작
• 설치
• 구성
• 사용
• 사용 가능한 도구
• 개발
• CI/CD,
• 배포
• 보안
• 기여
• 라이센스

---

빠른 시작

##1. 설치

GitHub에서 (추천)

릴리스 Artifacts에서

1. 출시 페이지로 이동
2. 최신 `을 다운로드합니다.

Wazuh MCP Server

A production-ready Model Context Protocol (MCP) server for seamless integration between Wazuh SIEM and Large Language Models (LLMs).

Why? Combine the power of Wazuh’s comprehensive security monitoring with the reasoning capabilities of large language models—enabling natural language queries and intelligent analysis of your security data.

---

✨ Key Features

• 🚀 Production-ready: Proper package structure, logging, error handling, and configuration management
• 🔐 Secure: JWT token management with automatic refresh
• 🌐 HTTP/2 Support: Built on modern async HTTP client with connection pooling
• 📊 Comprehensive API: Access Wazuh agents, authentication, and more
• 🎛️ Configurable: Environment variables, CLI arguments, and fine-grained tool filtering
• 📦 Pip installable: Install directly from GitHub releases or source

---

Table of Contents

• Quick Start
• Installation
• Configuration
• Usage
• Available Tools
• Development
• CI/CD
• Deployment
• Security
• Contributing
• License

---

Quick Start

1. Install

From GitHub (Recommended)

python -m venv .venv && source .venv/bin/activate
pip install git+https://github.com/socfortress/wazuh-mcp-server.git

From Release Artifacts

1. Go to the Releases page
2. Download the latest .whl file
3. Install with:

pip install wazuh_mcp_server-*.whl

From Build Artifacts (Latest Build)

1. Go to the Actions tab
2. Click on the latest successful workflow run
3. Download the python-package-distributions artifact
4. Extract and install:

pip install wazuh_mcp_server-*.whl

2. Configure Environment

Create a .env file in your project directory:

# Wazuh Manager Configuration
WAZUH_PROD_URL=https://your-wazuh-manager:55000
WAZUH_PROD_USERNAME=your-username
WAZUH_PROD_PASSWORD=your-password
WAZUH_PROD_SSL_VERIFY=false
WAZUH_PROD_TIMEOUT=30

# MCP Server Configuration
MCP_SERVER_HOST=127.0.0.1
MCP_SERVER_PORT=8000

# Logging Configuration
LOG_LEVEL=INFO