server_doctor
Read-onlyIdempotent
Run proactive health analysis on a server to detect disk trending full, high swap, stale packages, and more. Returns findings with remediation commands, using cached metrics by default or live data via SSH.
Instructions
Run proactive health analysis on a server. Detects disk trending full, high swap, stale packages, elevated fail2ban bans, audit regression streaks, old backups, and reclaimable Docker space. Uses cached metrics by default — pass fresh=true to fetch live data via SSH. Returns findings grouped by severity (critical/warning/info) with remediation commands. For a full scored security audit across 27 categories, use server_audit instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Skip per-finding confirmation prompts (CI-safe). Requires autoFix: true. | |
| fresh | No | Fetch live data via SSH instead of using cached metrics. Default: false (reads cache only). | |
| dryRun | No | Show what fixes would be applied without executing SSH. Requires autoFix: true. | |
| format | No | Output format: summary (grouped findings with counts), json (full DoctorResult). | summary |
| server | No | Server name or IP. Auto-selected if only one server exists. | |
| autoFix | No | Run diagnose->fix chain automatically. Default: false (read-only). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |