
Diskcleankit Mcp
io.github.namtran由 GitHub 帳號 namtran 發布v1.0.0更新於 Oct 24, 2026
MCP server for DiskCleanKit - One Touch Scan and Clean for Mac
概覽
讓 AI 助理透過 DiskCleanKit 應用程式掃描並清理 Mac 上的垃圾檔案,並查看磁碟空間與清理紀錄。
- 可以做什麼
- 掃描垃圾檔案而不刪除任何內容
- 自動掃描並清理安全的快取與日誌
- 查看磁碟空間與磁碟健康狀態
- 依類別估算可清理的空間
- 查看先前的清理工作紀錄
- 適用情境
- 當你想用自然語言請助理掃描 Mac 垃圾檔案、清理快取與日誌,或了解剩餘磁碟空間與可清理內容時適用。
- 執行需求
- 需要 macOS 並安裝 DiskCleanKit 應用程式,以及 Node.js v18 或更新版本,在本機以 stdio 執行此 npm 套件。未宣告任何 API 金鑰或環境變數。伺服器透過應用程式的 URL scheme 觸發應用程式,並從暫存檔讀取回應。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Diskcleankit Mcp,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
DiskCleanKit MCP Server
MCP (Model Context Protocol) server that enables AI assistants like Claude to control DiskCleanKit's One Touch feature for Mac disk cleaning.
Prerequisites
- macOS
- DiskCleanKit app installed
- Node.js v18+
Installation
Via npm (Recommended)
From Source
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Then restart Claude Desktop.
Claude Code (CLI)
Or edit ~/.claude/settings.json:
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project-specific):
Or go to Cursor Settings → Tools & Integrations → New MCP Server.
VS Code (GitHub Copilot)
Add to your settings.json:
Other MCP Clients
Use the same configuration structure:
Ollama (via mcphost)
Ollama doesn't natively support MCP, but you can use mcphost:
Unsupported
- ChatGPT: No native MCP support
Available Tools
What Gets Cleaned
one_touch_clean automatically scans and cleans safe items only:
These are all safe to delete and will be regenerated by the system/apps as needed.
Usage Examples
Once configured, ask your AI assistant:
- "Scan my Mac for junk files" →
one_touch_scan - "Clean up my Mac" →
one_touch_clean - "How much disk space do I have?" →
get_disk_status - "What can be cleaned?" →
get_cleanable_estimate - "Show my cleaning history" →
get_cleaning_history
How It Works
- AI calls MCP server tools
- MCP server triggers DiskCleanKit via
diskcleankit://URL scheme - DiskCleanKit processes request and writes response to
/tmp/diskcleankit_mcp_response.json - MCP server reads response and returns to AI
Security
one_touch_scanis safe - only scans, never deletesone_touch_cleanautomatically scans AND cleans safe items (caches & logs only)- Only cleans regenerable files - no personal data or documents are ever touched
- All processing happens locally on your Mac
- No data sent to external servers
Note: one_touch_clean is safe to run directly - it only removes system/app caches and logs that will be regenerated automatically.
Troubleshooting
"Timeout waiting for response"
- Ensure DiskCleanKit app is installed
- Try opening DiskCleanKit manually first
Server not appearing in Claude
- Verify config path is correct
- Restart Claude Desktop after config changes
- Check Claude logs for errors
License
MIT
Links
來源:README.md,提交 28bfdc4
工具
0版本歷史
1- v1.0.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分