server_doctor
Read-onlyIdempotent
Perform proactive server health analysis, detecting disk trending full, high swap, stale packages, and other issues. Returns severity-grouped findings with remediation commands.
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 |
|---|---|---|---|
| server | No | Server name or IP. Auto-selected if only one server exists. | |
| fresh | No | Fetch live data via SSH instead of using cached metrics. Default: false (reads cache only). | |
| format | No | Output format: summary (grouped findings with counts), json (full DoctorResult). | summary |
| autoFix | No | Run diagnose->fix chain automatically. Default: false (read-only). | |
| dryRun | No | Show what fixes would be applied without executing SSH. Requires autoFix: true. | |
| force | No | Skip per-finding confirmation prompts (CI-safe). Requires autoFix: true. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |