WinDirStat MCP Server 🧹📊

Model Context Protocol (MCP) Server for real-time Windows storage analysis, deep folder scanning, safety tiering, and protected cleanup operations.

Features & Exposed Tools

1. scan_directory

   • Deep scans a folder and returns all items with size (MB/GB), file counts, and last write dates.

2. get_largest_items

   • Ranks the top N largest files and subdirectories for any target path.

3. categorize_safety_tiers

   • Categorizes files/folders into Tier 1 (100% Safe Cache/Temp), Tier 2 (Reviewable Downloads/Media), and Tier 3 (Protected Code/Projects).

4. clean_safe_targets

   • Cleans temporary caches and specified paths with built-in protection guards preventing accidental deletion of project repositories.

Configuration / Installation

1. Claude Desktop Integration (claude_desktop_config.json)

Add the following entry to your %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "windirstat": {
      "command": "node",
      "args": [
        "C:\\Users\\Hariz\\windirstat-mcp\\index.js"
      ]
    }
  }
}

2. Antigravity IDE / Cursor / VS Code Integration

Add to your MCP settings configuration:

{
  "mcpServers": {
    "windirstat": {
      "command": "node",
      "args": [
        "C:/Users/Hariz/windirstat-mcp/index.js"
      ]
    }
  }
}