An MCP server that provides tools for macOS system diagnostics, process management, cache clearing, and health recommendations.
macOS-MCP has 6 tools with complete input schemas and descriptions, but quality is inconsistent. Tool names lack action verbs (mac_system_report, mac_run_command are acceptable; mac_health_recommendations is vague). Descriptions are present but generic, most lack WHEN to use guidance, prerequisites, or recovery hints. Parameters have types but many lack descriptions (e.g., mac_system_report has no params; mac_clear_caches has none). No output schemas documented. Error handling returns isError flags but no recovery guidance. Security concerns: mac_run_command and mac_kill_process are destructive but lack confirmation patterns or dry-run support. No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels.
Flushes DNS cache and clears common system caches to resolve networking or UI glitches.
Analyzes current CPU, memory, and disk pressure on the Mac and provides an actionable report of issues and recommended fixes (like processes to kill or caches to clear).
Force quits misbehaving applications or processes using their name.
Executes an arbitrary shell command on the Mac. Can optionally run with administrator privileges (will prompt the user visually). Use with caution.
Retrieves recent unified system logs from macOS (warnings and errors). This is useful for summarizing system instability or identifying why an app crashed.
Generates a diagnostic report of the macOS system including OS version, CPU, memory, and disk usage.
No output schemas documented. LLMs cannot predict response structure or plan downstream calls. mac_system_report returns markdown text; mac_summarize_logs returns truncated logs; mac_health_recommendations returns a report, none have formal output schemas.
Destructive tools lack confirmation or dry-run patterns. mac_run_command (arbitrary shell execution) and mac_kill_process (force quit) can cause data loss or system instability. No confirmation step, no dry-run mode, no recovery guidance.
Tool annotations missing. mac_run_command and mac_kill_process are marked DESTRUCTIVE in metadata but lack destructiveHint in schema. mac_system_report and mac_summarize_logs are READ_ONLY but lack readOnlyHint. Annotations help LLMs reason about safety.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
Error messages lack recovery guidance. mac_run_command returns isError=true with stderr but no hint on what to try next. mac_kill_process fails silently if process not found. Errors should guide the LLM toward resolution.
Descriptions lack WHEN-to-use context. mac_health_recommendations says 'Analyzes current CPU, memory, and disk pressure' but does not explain when to call it vs mac_system_report. mac_summarize_logs lacks guidance on filtering by process vs time window. Ambiguous descriptions force LLM guessing.