trash-cleaner-mcp-server

基本能力

产品定位

trash-cleaner-mcp-server 是一个专注于垃圾文件清理和文件系统管理的桌面服务，特别针对 macOS 进行了优化，但也计划支持其他操作系统。

核心功能

1. 智能扫描：识别各种类型的垃圾文件（缓存、日志、临时文件等）。
2. 选择性清理：提供多种工具清理特定区域，如应用缓存、临时文件、应用残留文件等。
3. VS Code 扩展管理：清理和管理 VS Code 及其兼容编辑器的扩展。
4. 文件系统工具：提供目录分析、文件查找、大小计算、删除等功能。
5. 系统信息：获取操作系统类型等基本信息。
6. 任务调度：支持通过 cron 表达式或简单间隔定义任务，自动化清理和其他操作。
7. 审计日志：跟踪操作记录。

适用场景

1. macOS 系统优化：清理系统垃圾文件，释放磁盘空间。
2. 开发者工具管理：清理和管理 VS Code 扩展。
3. 文件系统分析：分析目录内容、查找大文件等。
4. 自动化任务：通过任务调度定期执行清理或其他操作。

工具列表

1. macOS 清理工具：
2. cleanAppCaches：清理应用缓存。
3. cleanTempFiles：清理临时文件。
4. cleanAppRemnants：清理卸载应用后的残留文件。
5. smartCleanSystem：根据预设级别清理系统垃圾文件。
6. 跨平台工具：
7. cleanVSCodeExtensions：清理 VS Code 扩展。
8. findLargeFiles：查找大文件。
9. scanDirectory：分析目录内容。
10. deletePath：删除指定文件或文件夹。
11. 任务调度工具：
12. TrashCleaner_Scheduler_CreateTask：创建定时任务。
13. TrashCleaner_Scheduler_ListTasks：列出所有任务。
14. TrashCleaner_Scheduler_RunTaskNow：立即执行任务。

常见问题解答

1. 兼容性问题：大多数清理工具仅针对 macOS 设计和测试，其他系统可能无法正常工作。
2. 任务调度：任务定义存储在 ~/.trash-cleaner/schedules.json 中。

使用教程

使用依赖

1. 确保已安装 Bun.js 运行时环境。

安装教程

# 克隆仓库
git clone <repository-url>
cd trash-cleaner-mcp-server

# 安装依赖（使用 Bun）
bun install

运行服务器

bun start

调试方式

1. 日志配置位于 src/utils/logger.ts。
2. 可以通过 viewAuditLog 工具查看最近的日志记录。

bunx @childhoodandy/trash-cleaner-mcp-server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。