🚀 垃圾清理MCP服务
这是一款专为 macOS 打造的 MCP（消息处理程序）服务，主要功能是扫描、分析并清理系统中的垃圾文件。它具备丰富的功能模块，如垃圾文件清理、任务调度以及审计日志管理等，能有效提升系统性能和稳定性。
🚀 快速开始
克隆仓库
git clone
cd trash-cleaner-mcp-server
安装依赖
bun install
启动服务
bun start
✨ 主要特性
- 跨平台支持：虽主要面向 macOS，但部分功能在 Windows 和 Linux 系统也能使用。
- 智能扫描：可自动识别并分类各类垃圾文件。
- 选择性清理：用户能自主选择特定文件或目录进行清理。
- 任务调度：借助强大的任务调度功能，支持通过 cron 表达式自动化执行清理任务。
- 审计日志：详细记录系统操作日志，方便后续追溯与分析。
📦 安装指南
- 克隆仓库：
git clonecd trash-cleaner-mcp-server - 安装依赖：
bun install - 启动服务：
bun start
💻 使用示例
基础用法
macOS 专用工具
- TrashCleaner_CleanAppCaches：清理应用程序缓存文件。
- TrashCleaner_DeletePath：删除指定的文件或目录。删除操作需二次确认，对高风险路径会额外验证。
- TrashCleaner_ViewAuditLog：查看最新的审计日志内容，默认显示最近 100 条记录。
跨平台工具
- TrashCleaner_GetSystemType：返回操作系统标识符（如 'darwin' 表示 macOS，'win32' 表示 Windows，'linux' 表示 Linux）。
- TrashCleaner_CheckPathExists：检查指定路径是否存在，并判断其类型是文件还是目录。
- TrashCleaner_DeletePath：删除指定的文件或目录。删除操作需二次确认，对高风险路径会额外验证。
审计工具
- viewAuditLog：查看应用程序的主要日志文件（
combined.log）中的最近记录。 - clearAuditLog：删除主要的应用程序日志文件（
combined.log）。操作需确认。
高级用法
任务调度器 (TrashCleaner_Scheduler 工具)
创建任务
创建新任务需指定 name 和 cronExpression，并提供目标工具的名称或查询描述。支持设置任务参数和启用状态。
列出任务
列出所有已配置的任务及其状态信息。
获取任务详情
通过任务 ID 获取详细信息，包括任务名称、执行计划、目标工具等。
更新任务
更新现有任务的信息，包括任务名称、执行计划、目标工具（通过精确名称或模糊描述）、参数和启用状态。
启用/禁用任务
可对任务进行启停操作，灵活控制任务执行状态。
删除任务
永久删除指定的任务。
手动执行任务
手动触发任务立即执行，便于测试和应急处理。
📚 详细文档
配置信息
- 日志配置位于
src/utils/logger.ts。 - 任务调度定义存储在用户目录下的
~/.trash-cleaner/schedules.json。
开发指南
(此处将补充具体的开发规范和流程说明)
🔧 技术细节
- 使用语言：TypeScript
- 运行时环境：Bun.js