# io.github.namtran/diskcleankit-mcp (npm · @vannamtran/diskcleankit-mcp)

MCP server for DiskCleanKit - One Touch Scan and Clean for Mac

- Trust score: 65/100 (medium)
- Change this week: +19
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@vannamtran/diskcleankit-mcp`: 65/100 (this document), [markdown](https://verifymcp.io/servers/namtran-diskcleankit-mcp/vannamtran-diskcleankit-mcp.md), [page](https://verifymcp.io/servers/namtran-diskcleankit-mcp/vannamtran-diskcleankit-mcp)

## Channel facts

- Registry: `npm`
- Package: `@vannamtran/diskcleankit-mcp`
- Version: `1.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 218 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 599 tokens (~49/item across 12 items; 12 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add namtran-diskcleankit-mcp -- npx -y @vannamtran/diskcleankit-mcp
```

### Codex

```bash
codex mcp add namtran-diskcleankit-mcp -- npx -y @vannamtran/diskcleankit-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "namtran-diskcleankit-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@vannamtran/diskcleankit-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add namtran-diskcleankit-mcp --command npx --arg -y --arg @vannamtran/diskcleankit-mcp
```

### Hermes

```yaml
mcp_servers:
  namtran-diskcleankit-mcp:
    command: "npx"
    args: ["-y", "@vannamtran/diskcleankit-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "namtran-diskcleankit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vannamtran/diskcleankit-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 65, +22)

- [security regression] Install scripts: pass → unverified
- [security regression] Provenance: fail → unverified
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional regression] License: pass → unverified
- [functional regression] Maintenance: pass → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional] Licence: MIT

### 2026-07-31 (score 43, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 50, −30)

- [security regression] Malware scan: pass → unverified
- [security regression] Known CVEs: partial → unverified
- [functional regression] Dependency health: partial → unverified

### 2026-07-29 (score 80, +55)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] License: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional] Licence: MIT

### 2026-07-28 (score 25, −21)

- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] Dependency health: unverified → partial
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (12)

### `one_touch_scan` (~49 tokens)

Run DiskCleanKit One Touch Scan - automatically scans your Mac for junk files, caches, logs, and system debris. Shows what can be cleaned WITHOUT deleting anything. Always run this first before cleaning.

### `one_touch_clean` (~50 tokens)

Run DiskCleanKit One Touch Clean - automatically cleans the items found by the previous scan. WARNING: This deletes files immediately without confirmation. Always run one_touch_scan first and get user approval before calling this.

### `get_disk_status` (~37 tokens)

Get current disk space status including total space, free space, used space, usage percentage, and health status (healthy/warning/critical).

### `get_cleanable_estimate` (~41 tokens)

Estimate how much space can be cleaned by One Touch Clean. Returns breakdown by category (caches, logs, Xcode data, trash, etc.).

### `get_cleaning_history` (~63 tokens)

Get history of past cleaning sessions including total space freed, number of sessions, and details of recent cleans. Use this to answer 'how much did I clean last week?'

Input parameters:

- `limit` (number): Maximum number of sessions to return (default: 10)

### `get_storage_breakdown` (~44 tokens)

Get detailed storage breakdown by category (Documents, Downloads, Developer, Caches, etc.). Use this to answer 'What's eating my disk space?' with specific category sizes.

### `get_large_files` (~88 tokens)

Find large files on the Mac. Returns a list of the biggest files with their paths, sizes, and types. Use this to answer 'what are these large files?' or 'find big files'.

Input parameters:

- `limit` (number): Maximum number of files to return (default: 20)
- `min_size_mb` (number): Minimum file size in MB to include (default: 100)

### `get_dev_caches` (~58 tokens)

Analyze developer tool caches: Xcode derived data, iOS simulators, npm, Yarn, CocoaPods, Homebrew, Gradle, Maven, Docker. Use this to answer 'clean all my dev caches' or help developers specifically.

### `show_disk_manager` (~49 tokens)

Open DiskCleanKit's Disk Manager screen and auto-scan the system disk. Shows visual storage breakdown with charts. Use this when user wants to SEE their disk usage, or for first-time demos.

### `show_one_touch` (~40 tokens)

Open DiskCleanKit's One Touch Clean screen. Brings app to front for user interaction. Use this when user wants to manually control the cleaning process.

### `show_cleaning_history` (~40 tokens)

Open DiskCleanKit's Cleaning History screen. Shows past cleaning sessions with charts and statistics. Use this when user wants to visually review their cleaning history.

### `show_dashboard` (~40 tokens)

Open DiskCleanKit's main Dashboard. Shows overview of disk health, quick actions, and recommendations. Use this as a general entry point to show the app.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/namtran-diskcleankit-mcp/vannamtran-diskcleankit-mcp#diagnostics

## Score history

- 2026-08-03: 65
- 2026-08-02: 65
- 2026-08-01: 43
- 2026-07-31: 43
- 2026-07-30: 50
- 2026-07-29: 80
- 2026-07-28: 25
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/@vannamtran/diskcleankit-mcp
- Socket report: https://socket.dev/npm/package/@vannamtran/diskcleankit-mcp
- Repository: https://github.com/namtran/diskcleankit-mcp
- Changelog RSS feed: https://verifymcp.io/servers/namtran-diskcleankit-mcp/vannamtran-diskcleankit-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/namtran-diskcleankit-mcp/vannamtran-diskcleankit-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/namtran-diskcleankit-mcp/vannamtran-diskcleankit-mcp