
跨越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服务器.
- 清除存储器
& 2. 创建您的环境文件
至少填写 :
- 启动容器
4. 校正运行中
查看日志 :
停止并重新启动 :
– – . . .
□快起步-局部(系统)
如果您想在Wazuh服务器上直接运行而无需多克, 请使用此功能 。
- 克隆和安装
2. 配置
- 作为系统服务运行
本页由 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
- Quick Start — Local (systemd)
- Connect Claude Desktop
- Environment Variables
- Tool Reference
- MCP Prompts
- Architecture
- Optional Integrations
- Security Considerations
- Common Issues
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
安装
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"
]
}
}
}