{
  "markdown": "# DiskCleanKit MCP Server\n\n[![npm version](https://badge.fury.io/js/@vannamtran%2Fdiskcleankit-mcp.svg)](https://www.npmjs.com/package/@vannamtran/diskcleankit-mcp)\n\nMCP (Model Context Protocol) server that enables AI assistants like Claude to control DiskCleanKit's **One Touch** feature for Mac disk cleaning.\n\n## Prerequisites\n\n- macOS\n- [DiskCleanKit](https://diskcleankit.com) app installed\n- Node.js v18+\n\n## Installation\n\n### Via npm (Recommended)\n\n```bash\nnpm install -g @vannamtran/diskcleankit-mcp\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/namtran/diskcleankit-mcp\ncd diskcleankit-mcp\nnpm install\nnpm run build\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"diskcleankit\": {\n      \"command\": \"npx\",\n      \"args\": [\"@vannamtran/diskcleankit-mcp\"]\n    }\n  }\n}\n```\n\nThen restart Claude Desktop.\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add --transport stdio diskcleankit -- npx @vannamtran/diskcleankit-mcp\n```\n\nOr edit `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"diskcleankit\": {\n      \"command\": \"npx\",\n      \"args\": [\"@vannamtran/diskcleankit-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-specific):\n\n```json\n{\n  \"mcpServers\": {\n    \"diskcleankit\": {\n      \"command\": \"npx\",\n      \"args\": [\"@vannamtran/diskcleankit-mcp\"]\n    }\n  }\n}\n```\n\nOr go to **Cursor Settings → Tools & Integrations → New MCP Server**.\n\n### VS Code (GitHub Copilot)\n\nAdd to your `settings.json`:\n\n```json\n{\n  \"mcp.servers\": {\n    \"diskcleankit\": {\n      \"command\": \"npx\",\n      \"args\": [\"@vannamtran/diskcleankit-mcp\"]\n    }\n  }\n}\n```\n\n### Other MCP Clients\n\n| Client | Config File |\n|--------|-------------|\n| Cline | VS Code extension settings |\n| Windsurf | `~/.windsurf/mcp.json` |\n| Zed | `~/.config/zed/settings.json` |\n| Continue | `~/.continue/config.json` |\n\nUse the same configuration structure:\n\n```json\n{\n  \"mcpServers\": {\n    \"diskcleankit\": {\n      \"command\": \"npx\",\n      \"args\": [\"@vannamtran/diskcleankit-mcp\"]\n    }\n  }\n}\n```\n\n### Ollama (via mcphost)\n\nOllama doesn't natively support MCP, but you can use [mcphost](https://github.com/chrishayuk/mcp-cli):\n\n```bash\npip install mcphost\nmcphost -m ollama:qwen2.5 --config config.json\n```\n\n### Unsupported\n\n- **ChatGPT**: No native MCP support\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `one_touch_scan` | Scan for junk files (safe, no deletion) |\n| `one_touch_clean` | **Recommended** - Scan AND clean junk files automatically |\n| `get_disk_status` | Check disk space and health status |\n| `get_cleanable_estimate` | Estimate cleanable space by category |\n| `get_cleaning_history` | View past cleaning sessions |\n\n## What Gets Cleaned\n\n`one_touch_clean` automatically scans and cleans **safe items only**:\n\n| Category | Description |\n|----------|-------------|\n| **System Caches** | macOS system cache files |\n| **Application Caches** | App-generated cache files |\n| **Application Logs** | Old log files from apps |\n| **Browser Caches** | Safari, Chrome, Firefox cache |\n\nThese are all safe to delete and will be regenerated by the system/apps as needed.\n\n## Usage Examples\n\nOnce configured, ask your AI assistant:\n\n- \"Scan my Mac for junk files\" → `one_touch_scan`\n- \"Clean up my Mac\" → `one_touch_clean`\n- \"How much disk space do I have?\" → `get_disk_status`\n- \"What can be cleaned?\" → `get_cleanable_estimate`\n- \"Show my cleaning history\" → `get_cleaning_history`\n\n## How It Works\n\n```\nAI Assistant → MCP Server → URL Scheme → DiskCleanKit App\n                   ↑                            ↓\n              JSON Response ← Temp File ← Response\n```\n\n1. AI calls MCP server tools\n2. MCP server triggers DiskCleanKit via `diskcleankit://` URL scheme\n3. DiskCleanKit processes request and writes response to `/tmp/diskcleankit_mcp_response.json`\n4. MCP server reads response and returns to AI\n\n## Security\n\n- `one_touch_scan` is safe - only scans, never deletes\n- `one_touch_clean` automatically scans AND cleans safe items (caches & logs only)\n- Only cleans regenerable files - no personal data or documents are ever touched\n- All processing happens locally on your Mac\n- No data sent to external servers\n\n**Note:** `one_touch_clean` is safe to run directly - it only removes system/app caches and logs that will be regenerated automatically.\n\n## Troubleshooting\n\n### \"Timeout waiting for response\"\n- Ensure DiskCleanKit app is installed\n- Try opening DiskCleanKit manually first\n\n### Server not appearing in Claude\n- Verify config path is correct\n- Restart Claude Desktop after config changes\n- Check Claude logs for errors\n\n## License\n\nMIT\n\n## Links\n\n- [DiskCleanKit App](https://diskcleankit.com)\n- [MCP Protocol](https://modelcontextprotocol.io)\n",
  "bytes": 4890,
  "sha": "5dbd3be52f095f04038f4f8e18b7fed00170b7d3fcb76c42b703e8bc8cfb15c4",
  "repo_slug": "namtran/diskcleankit-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_namtran_diskcleankit_mcp_29a7d35b/readme"
}