Trash Cleaner MCP Server

🚀 垃圾清理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
   

💻 使用示例

基础用法

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 获取详细信息，包括任务名称、执行计划、目标工具等。

更新任务

更新现有任务的信息，包括任务名称、执行计划、目标工具（通过精确名称或模糊描述）、参数和启用状态。

启用/禁用任务

可对任务进行启停操作，灵活控制任务执行状态。

删除任务

永久删除指定的任务。

手动执行任务

手动触发任务立即执行，便于测试和应急处理。

📚 详细文档

配置信息

• 日志配置位于 src/utils/logger.ts。
• 任务调度定义存储在用户目录下的 ~/.trash-cleaner/schedules.json。

开发指南

(此处将补充具体的开发规范和流程说明)

🔧 技术细节

• 使用语言：TypeScript
• 运行时环境：Bun.js