Trash Cleaner MCP Server

macOSWarning

Displays a warning if run on a non-macOS system.

cleanAppCaches

Cleans various application caches (user cache, saved app state).

cleanTempFiles

Cleans system temporary files.

cleanAppRemnants

Scans for and cleans configuration/cache files left by uninstalled applications.

smartCleanSystem

Performs system cleaning based on predefined levels (targets common junk locations).

cleanVSCodeExtensions

Cleans outdated versions of VS Code (and compatible editors like VSCodium, Cursor) extensions.

reportVSCodeExtensions

Generates a report listing outdated VS Code extensions that can be cleaned.

findLargeFiles

Finds files exceeding a specified size within a directory.

scanFullSystem

Scans the entire system's file structure (respecting exclusions) to report on space usage.

scanDirectory

Analyzes the contents and size distribution within a specific directory.

getFolderSize

Calculates and returns the total size of a folder.

listDirectory

Lists the files and subdirectories within a specified path.

findFiles

Searches for files matching a specific pattern (wildcards supported) within a directory.

analyzeDirectory

Provides statistics on file types and size distribution within a directory.

getFileHash

Computes the MD5, SHA1, or SHA256 hash of a file.

getFileType

Retrieves basic file information, including MIME type.

deletePath

Deletes a specified file or folder (requires explicit confirmation, with extra checks for dangerous paths).

checkPathExists

Checks if a given path exists and identifies if it's a file or directory.

getSystemType

Returns the operating system identifier (e.g., 'darwin', 'win32', 'linux').

viewAuditLog

Views the most recent lines from the application's main log file (combined.log).

clearAuditLog

Deletes the main application log file (combined.log).

TrashCleaner_Scheduler_CreateTask

Creates a new scheduled task.

TrashCleaner_Scheduler_ListTasks

Lists all configured scheduled tasks and their status.

TrashCleaner_Scheduler_GetTaskDetails

Gets detailed information about a specific task by ID.

TrashCleaner_Scheduler_UpdateTask

Updates an existing task.

TrashCleaner_Scheduler_EnableTask

Enables a disabled task.

TrashCleaner_Scheduler_DisableTask

Disables an enabled task.

TrashCleaner_Scheduler_DeleteTask

Permanently deletes a scheduled task.

TrashCleaner_Scheduler_RunTaskNow

Manually triggers the execution of a task immediately.

TrashCleaner_Scheduler_GetTaskHistory

Retrieves the recent execution history (success/failure) for a task.