AW

adi5353/wazuh-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

15 stars 6 forks 质量 75 趋势 25Apache-2.0

跨越21个域单元——警报,弱点,FIM,遵守,MITRE ATT&CK,威胁猎取,主动响应,舰队清单,SCA,CDB列表,规则,威胁情报,事件,报告,......

概览

涵盖21个域单元——警报、脆弱性、FIM、合规、MITRE ATT&CK、威胁猎取、积极反应、车队清单、SCA、CDB清单、规则、威胁情报、事件、报告、通知、登机、集群健康、档案搜索和警戒压制。 这是建议的部署方法。 容器会捆绑所有依赖性,并会曝光端口8000上的MCP服务器. 如果您想在Wazuh服务器上直接运行而无需多克, 请使用此功能 。 在运行克洛德桌面的机器上安装mcp-remote(需要节点.js 18+): Fully退出克洛德桌面(Tray 图标 ~)并重启. 您应该在聊天输入中看到工具图标 。 如果克劳德桌面和MCP服务器运行在同一台机器上,则使用stdio transport: 以 Claude 代码和即时意识客户端中的命令提供 。 所有整合都是选入. 如果缺少证书,则工具会优雅地降解.

概述(AI 翻译)

** Wazuh连接到Claude AI,通过示范背景协议(MCP),直接在Claude桌面内进行自然语言安全操作。 **

** 87项工具** 涵盖21个域单元——警报、脆弱性、财务信息、合规、MITRE ATT&CK、威胁猎取、积极反应、车队库存、SCA、CDB清单、规则、威胁情报、事件、报告、通知、登机、集群健康、档案搜索和警戒压制。

– – . . .

□ 目录

  • 快速启动—— Docker
  • 快速启动——局部(系统)
  • 连接克洛德桌面
  • 环境变量
  • 工具参考
  • MCP提示
  • 建筑
  • 可选融合
  • 安全考虑
  • 共同问题

– – . . .

□快起步——多克

这是建议的部署方法。 容器会捆绑所有依赖性,并会曝光端口8000上的MCP服务器.

  1. 清除存储器

& 2. 创建您的环境文件

至少填写 :

  1. 启动容器

4. 校正运行中

查看日志 :

停止并重新启动 :

– – . . .

□快起步-局部(系统)

如果您想在Wazuh服务器上直接运行而无需多克, 请使用此功能 。

  1. 克隆和安装

2. 配置

  1. 作为系统服务运行

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Wazuh MCP — AI-Powered Security Operations

Connect Wazuh to Claude AI via the Model Context Protocol (MCP), enabling natural-language security operations directly inside Claude Desktop.

87 tools across 21 domain modules — alerts, vulnerabilities, FIM, compliance, MITRE ATT&CK, threat hunting, active response, fleet inventory, SCA, CDB lists, rules, threat intel, incidents, reporting, notifications, onboarding, cluster health, archive search, and alert suppression.


Table of Contents


Quick Start — Docker

This is the recommended deployment method. The container bundles all dependencies and exposes the MCP server on port 8000.

1. Clone the repository

git clone https://github.com/adi5353/wazuh-mcp.git
cd wazuh-mcp

2. Create your environment file

cp env.example .env
nano .env

Fill in at minimum:

WAZUH_HOST=https://your-wazuh-manager:55000
WAZUH_USER=wazuh-mcp
WAZUH_PASS=YourPassword

WAZUH_INDEXER_HOST=https://your-wazuh-indexer:9200
WAZUH_INDEXER_USER=wazuh-readonly
WAZUH_INDEXER_PASS=YourPassword

WAZUH_VERIFY_SSL=false
WAZUH_MCP_TRANSPORT=http
WAZUH_MCP_HOST=0.0.0.0
WAZUH_MCP_PORT=8000

3. Start the container

docker compose up -d

4. Verify it’s running

docker compose ps
curl -si http://localhost:8000/sse | head -3
# Expected: HTTP/1.1 200 OK

View logs:

docker compose logs -f wazuh-mcp

Stop and restart:

docker compose down
docker compose up -d

Quick Start — Local (systemd)

Use this if you want to run directly on the Wazuh server without Docker.

1. Clone and install

git clone https://github.com/adi5353/wazuh-mcp.git
cd wazuh-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Configure

cp env.example .env
nano .env   # fill in WAZUH_HOST, WAZUH_USER, WAZUH_PASS, indexer credentials

3. Run as a systemd service

sudo tee /etc/systemd/system/wazuh-mcp.service << 'EOF'
[Unit]
Description=Wazuh MCP Server
After=network.target

[Service]
Type=simple
User=vagrant
WorkingDirectory=/home/vagrant/wazuh-mcp
EnvironmentFile=/home/vagrant/wazuh-mcp/.env
ExecStart=/home/vagrant/wazuh-mcp/.venv/bin/python -m wazuh_mcp
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now wazuh-mcp
sudo systemctl status wazuh-mcp

Verify:

ss -tlnp | grep 8000   # must show 0.0.0.0:8000
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "wazuh": { "command": "mcp-remote", "args": [ "http://YOUR_SERVER_IP:8000/sse", "--allow-http" ] } } }