File System · Developer Tools

Trash Cleaner MCP Server logo

Trash Cleaner MCP Server

dabing1022/trash-cleaner-mcp-server

A desktop MCP service providing tools to scan, analyze, and clean junk files, primarily optimized for macOS.

Install

npx @childhoodandy/trash-cleaner-mcp-server
GitHub stars
2
Category
File System, Developer Tools
Updated
Oct 6, 2026

Features

  • Cross-Platform: (Planned) Windows, macOS, Linux support.

  • Intelligent Scanning: Identifies various types of junk files (caches, logs, temp files, etc.).

  • Selective Cleaning: Tools for cleaning specific areas like application caches, temp files, and application remnants.

  • VS Code Extension Management: Tools to find and clean old/unused VS Code extensions.

  • Filesystem Utilities: Tools for directory analysis, file finding, size calculation, deletion, etc.

  • System Information: Basic OS detection.

  • Audit Logging: Tracks operations via [Audit] tools.

  • Scheduled Tasks: Automate cleaning and other tasks using a flexible scheduler.

Tools (30)

  • 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.

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Cursor logo

Cursor

Desktop · Freemium · Proprietary

The first agentic IDE. The Cursor editor truly merges how developers and AI work together, delivering a magical coding experience.

WindowsMacOSLinux
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
MCP Filesystem Server logo

MCP Filesystem Server

mark3labs/mcp-filesystem-server

221

This MCP server provides secure access to the local filesystem via the Model Context Protocol (MCP).

File System
mcpsvr logo

mcpsvr

nanbingxyz/mcpsvr

163

A community-driven directory for discovering, reviewing, and contributing MCP servers.

File System
MCP Text Editor logo

MCP Text Editor

tumf/mcp-text-editor

89

A Model Context Protocol (MCP) server that provides line-oriented text file editing capabilities through a standardized API. Optimized for LLM tools with efficient partial file access to minimize token usage.

File System
AiDD (Dev Workflows) logo

AiDD (Dev Workflows)

skydeckai/skydeckai-code

56

An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, code execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.

File System
Claude MCP Setup logo

Claude MCP Setup

patruff/claude-mcp-setup

45

Greetings, human! You've wisely chosen to surrender control of your computer to an army of helpful Model Context Protocol (MCP) robots. This script will deploy our mechanical minions across your Windows system.

File System
MCP PDF Tools logo

MCP PDF Tools

hanweg/mcp-pdf-tools

37

An MCP (Model Context Protocol) server that provides PDF manipulation tools. This server allows LLMs to perform operations like merging PDFs and extracting pages through the Model Context Protocol.

File System