---

🌟 Overview

The WizTree MCP Server seamlessly bridges your AI assistant (Claude, Cursor, Antigravity, etc.) with WizTree, allowing your AI to instantly scan your hard drives, identify massive space hogs, and execute intelligent cleanups.

Turn your AI into a highly contextual storage manager!

✨ Features

• ⚡ Lightning Fast: Leverages WizTree's MFT (Master File Table) reading to scan drives in seconds.
• 🧠 AI-Powered Workflows: Ask your AI: "What's eating up space on my C: drive?" or "Analyze my Downloads folder."
• 🛡️ Built-in Guardrails: Comes with a comprehensive /skills directory to teach your AI strict deletion policies and safe handling of files.
• 💻 Developer Focused: Perfect for finding hidden node_modules, stray __pycache__ folders, or giant dangling Docker images.

---

🧠 AI Agent Skills

Unlike basic MCP servers that just dump raw data, this repository includes a dedicated /skills directory and a SYSTEM_PROMPT.md. These Markdown files teach your AI client how to use the tools effectively and safely.

Available skills include:

• 🛡️ Deletion Policy: Enforces a strict multi-step workflow before any files are deleted.
• 🗑️ Safe Delete: Defines exactly what is safe to delete (e.g., caches) and what should never be touched (e.g., system files).
• 👨‍💻 Developer Cleanup: Gives the AI deep knowledge of where dev tools (Docker, npm, pip) hide their massive cache files.

---

🚀 Installation

1. Prerequisites

• Windows OS
• WizTree (installed at C:\Program Files\WizTree\WizTree64.exe)
• Python 3.10+

2. Clone the Repository

git clone https://github.com/sahmed730/Wiztree-Mcp.git
cd Wiztree-Mcp

3. Setup Virtual Environment

python -m venv .venv
.\.venv\Scripts\Activate
pip install -r requirements.txt

---

⚙️ Configuration

Add the server to your MCP client configuration (e.g., mcp_config.json for Antigravity, or claude_desktop_config.json for Claude):

{
  "mcpServers": {
    "wiztree": {
      "command": "C:\\path\\to\\Wiztree-Mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\Wiztree-Mcp\\server.py"
      ]
    }
  }
}

⚠️ Note: Replace C:\\path\\to\\ with the exact absolute path to your cloned directory.

---

🤖 Example Prompts

Once connected, try asking your AI:

• 💬 "Can you find the 15 largest files on my C: drive?"
• 💬 "My SSD is full. Find the largest folders in my user profile, skipping my personal photos."
• 💬 "Do a developer cleanup on my machine to free up at least 20 GB."

---