@dabing1022
基本信息
A desktop MCP service that scans for and removes junk files to keep your system clean and optimized.
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"trash-cleaner-mcp-server": {
"command": "npx",
"args": [
"@childhoodandy/trash-cleaner-mcp-server"
]
}
}
}获取当前操作系统的类型（例如：darwin, win32, linux）。
获取指定文件夹的大小（字节）。
列出指定目录下的所有文件和子目录。
在指定目录中查找符合条件的文件。
在指定目录中查找符合条件的文件和文件夹。
在指定目录中查找符合条件的文件夹。
分析目录中文件的类型分布、大小分布等信息。
计算文件的 MD5/SHA256 哈希值，用于文件完整性校验。
获取文件的MIME类型和基本信息。
删除指定文件或文件夹。默认永久删除，可通过 useTrash 选项移到系统垃圾桶。需用户确认。
检查指定的文件或目录路径是否存在。
清空操作系统垃圾桶。这是一个不可恢复的操作！请谨慎使用。
显示当前系统不是 macOS 的警告信息。
清理各种应用程序缓存文件，包括用户缓存目录、应用程序保存的状态等。仅适用于 macOS 系统。
清理系统临时文件目录中的临时文件。仅适用于 macOS 系统。
清理已卸载应用程序的配置文件、缓存和其他残留文件。仅适用于 macOS 系统。
智能清理系统垃圾文件，支持不同的清理级别。仅适用于 macOS 系统。
清理 VSCode 及相关编辑器的低版本扩展。
生成 VSCode 及相关编辑器低版本扩展的报告。
在指定目录中查找超过指定大小的大文件。
执行全盘扫描，识别文件分布和大小情况
扫描指定目录，分析文件分布和大小情况
扫描常见类型的垃圾文件 (缓存, 临时文件, 日志等)。依赖于 junk_rules.json 配置文件。
查看应用程序最近的运行日志（combined.log）。
清空应用程序的主运行日志文件（combined.log）。这是一个破坏性操作，请谨慎使用！
trash-cleaner-mcp-server is a desktop MCP service that provides tools to scan, analyze, and clean junk files. It is primarily optimized for macOS, with cross-platform support (Windows, Linux) planned. The server is built with Bun.js and TypeScript and is intended for users who want to manage system clutter, application remnants, and temporary files programmatically via the Model Context Protocol.
The server can be run using bunx @childhoodandy/trash-cleaner-mcp-server or npx @childhoodandy/trash-cleaner-mcp-server. For development, clone the repository, run bun install, then bun start. Configuration for logging is in src/utils/logger.ts and scheduled task definitions are stored at ~/.trash-cleaner/schedules.json. The server registers numerous tools callable via MCP, with most cleaning tools marked as macOS-only.
Most cleaning tools (`cleanAppCaches`, `cleanTempFiles`, `cleanAppRemnants`, `smartCleanSystem`) are designed and tested specifically for macOS. Cross-platform support for Windows and Linux is planned. The server can report the operating system via `getSystemType`.
Use the `TrashCleaner_Scheduler` tools. You can create a task by specifying a name, a cron expression, and either an exact `toolName` or a fuzzy `toolQuery` (e.g., "clean app caches"). Tasks can be listed, updated, enabled, disabled, deleted, triggered manually, and their execution history can be viewed.
Audit logs are written to a `combined.log` file. The `viewAuditLog` tool reads from this file. Scheduled task definitions are stored in `~/.trash-cleaner/schedules.json`.
Use the `deletePath` tool. It requires explicit confirmation (`confirm: true`) and an additional `dangerConfirm` flag for potentially risky deletions. Extra checks are in place to prevent accidental deletion of critical paths.
Most cleaning tools accept a `dryRun` option (default `true`) to preview changes without deleting. Some support an `olderThan` parameter (in days). The `smartCleanSystem` tool has a `cleanLevel` enum with values "safe", "normal", and "deep".
Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
MCP Toolbox for Databases is an open source MCP server for databases.
Open-source MCP to use Blender with any LLM
评论