Trash Cleaner MCP Server

一个桌面MCP服务，提供扫描、分析和清理垃圾文件的工具，主要针对macOS优化，支持跨平台计划任务管理。

开发者工具文件系统 #垃圾清理 #macOS优化 #计划任务本地 .TypeScript

评分 : 2.5分

下载量 : 11

更新时间 : 2025-04-29

什么是Trash Cleaner MCP 服务器？

Trash Cleaner MCP 服务器是一个多功能工具集，旨在帮助用户清理系统中的无用文件，例如缓存、临时文件和残留配置文件。它支持跨平台操作，并提供了智能扫描和选择性清理功能。

如何使用Trash Cleaner MCP 服务器？

通过简单的命令行操作，您可以快速启动服务、创建任务并执行清理工作。只需几步即可完成整个流程。

适用场景

适用于需要定期清理Mac设备上的无用文件的用户，尤其是开发者和IT专业人士。

主要功能

跨平台支持支持Windows、macOS和Linux操作系统。

智能扫描能够识别多种类型的垃圾文件，包括缓存、日志和临时文件。

选择性清理提供针对特定区域（如应用缓存、临时文件和残留文件）的清理工具。

VS Code扩展管理帮助您找到并清理旧版或未使用的VS Code扩展。

文件系统实用工具提供目录分析、文件查找、大小计算、删除等功能。

系统信息提供基本的操作系统检测功能。

审计日志通过'[Audit]'工具跟踪操作记录。

计划任务通过灵活的调度器实现自动化清理和其他任务。

优势与局限性

优势

高效清理垃圾文件，提升系统性能。

支持多种平台，满足不同用户需求。

智能识别文件类型，减少误删风险。

灵活的任务调度机制，满足个性化需求。

内置详细的日志记录，便于追踪操作历史。

局限性

部分功能可能不完全兼容其他操作系统。

高级清理功能需要较高的权限，可能导致误操作。

依赖于Bun.js运行环境，需确保安装正确。

如何使用

安装服务器

克隆仓库并安装依赖项。

启动服务器

使用Bun.js启动服务器。

执行清理任务

通过命令行调用相应的工具进行清理。

使用案例

清理临时文件演示如何使用工具清理系统临时文件。

清理VS Code扩展演示如何清理过时的VS Code扩展。

常见问题

是否支持Windows系统？

清理过程中是否会误删重要文件？

如何查看清理日志？

🚀 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 表达式自动化执行清理任务。
审计日志：详细记录系统操作日志，便于追溯和分析。

📦 安装指南

克隆仓库：

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

安装依赖：
```
bun install
```
启动服务：
```
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 专用工具

TrashCleaner_CleanAppCaches：清理应用程序缓存文件。
TrashCleaner_DeletePath：删除指定的文件或目录，删除操作需二次确认，对高风险路径会额外验证。
TrashCleaner_ViewAuditLog：查看最新的审计日志内容，默认显示最近 100 条记录。

跨平台工具

TrashCleaner_GetSystemType：返回操作系统标识符（如 'darwin' 表示 macOS，'win32' 表示 Windows，'linux' 表示 Linux）。
TrashCleaner_CheckPathExists：检查指定路径是否存在，并判断其类型是文件还是目录。
TrashCleaner_DeletePath：删除指定的文件或目录，删除操作需二次确认，对高风险路径会额外验证。