Trash Cleaner MCP Server

🚀 Trash Cleaner MCP 服務

Trash Cleaner MCP 服務是專門為 macOS 設計的 MCP（消息處理程序）服務，可掃描、分析並清理垃圾文件。它具備豐富的功能模塊，涵蓋垃圾文件清理、任務調度以及審計日誌管理等，為用戶提供高效的垃圾清理解決方案。

🚀 快速開始

克隆倉庫

git clone <repository-url>
cd trash-cleaner-mcp-server

安裝依賴

bun install

啟動服務

bun start

✨ 主要特性

• 跨平臺支持：雖主要面向 macOS，部分功能也適用於 Windows 和 Linux。
• 智能掃描：自動識別並分類各類垃圾文件。
• 選擇性清理：用戶可選擇特定文件或目錄進行清理。
• 任務調度：強大的任務調度功能，支持通過 cron 表達式自動化執行清理任務。
• 審計日誌：詳細記錄系統操作日誌，便於追溯和分析。

📦 安裝指南

1. 克隆倉庫：

   git clone <repository-url>
   cd trash-cleaner-mcp-server
   

2. 安裝依賴：

   bun install
   

3. 啟動服務：

   bun start
   

💻 使用示例

基礎用法

以下是使用該服務進行垃圾清理和任務調度的基本步驟：

# 克隆倉庫
git clone <repository-url>
cd trash-cleaner-mcp-server

# 安裝依賴
bun install

# 啟動服務
bun start

高級用法

創建任務調度

# 創建一個每天凌晨 2 點執行的清理任務
TrashCleaner_Scheduler create --name "Daily Cleanup" --cronExpression "0 2 * * *" --tool "TrashCleaner_DeletePath" --params "/path/to/clean"

📚 詳細文檔

使用工具

macOS 專用工具

1. TrashCleaner_CleanAppCaches：清理應用程序緩存文件。
2. TrashCleaner_DeletePath：刪除指定的文件或目錄，刪除操作需二次確認，對高風險路徑會額外驗證。
3. TrashCleaner_ViewAuditLog：查看最新的審計日誌內容，默認顯示最近 100 條記錄。

跨平臺工具

4. TrashCleaner_GetSystemType：返回操作系統標識符（如 'darwin' 表示 macOS，'win32' 表示 Windows，'linux' 表示 Linux）。
5. TrashCleaner_CheckPathExists：檢查指定路徑是否存在，並判斷其類型是文件還是目錄。
6. TrashCleaner_DeletePath：刪除指定的文件或目錄，刪除操作需二次確認，對高風險路徑會額外驗證。

審計工具

• viewAuditLog：查看應用程序的主要日誌文件（combined.log）中的最近記錄。
• clearAuditLog：刪除主要的應用程序日誌文件（combined.log），操作需確認。

任務調度器 (TrashCleaner_Scheduler 工具)

創建任務

創建新任務需指定 name 和 cronExpression，並提供目標工具的名稱或查詢描述，支持設置任務參數和啟用狀態。

列出任務

列出所有已配置的任務及其狀態信息。

獲取任務詳情

通過任務 ID 獲取詳細信息，包括任務名稱、執行計劃、目標工具等。

更新任務

更新現有任務的信息，包括任務名稱、執行計劃、目標工具（通過精確名稱或模糊描述）、參數和啟用狀態。

啟用/禁用任務

可對任務進行啟停操作，靈活控制任務的執行狀態。

刪除任務

永久刪除指定的任務。

手動執行任務

手動觸發任務立即執行，便於測試和應急處理。

🔧 技術細節

• 使用語言：TypeScript
• 運行時環境：Bun.js

配置信息

開發指南

(此處將補充具體的開發規範和流程說明)