Disk Usage MCP Server

Example Use Cases

• 1

  Real-time macOS system disk usage metrics to inform users about available space and potential cleanup actions.

• 2

  Convert raw system disk statistics into a clear, human-readable summary for chat responses or notifications.

• 3

  Integrate local system health checks (disk usage) into Claude workflows via MCP/JSON-RPC.

Description

This demo MCP server exposes a get_disk_usage tool that runs macOS disk commands, parses the results, and returns structured disk usage data (total, used, available, reserved, percent, mount, device, and a human summary). It is intended to integrate with Claude Desktop using MCP (JSON-RPC over WebSocket) so agents can request and receive live system disk information. Useful for monitoring disk capacity and producing user-friendly responses or automated cleanup recommendations. Designed specifically for macOS and provided as a simple Python example.