vacumify-mcp 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,48 @@
1
- # Temporary Holding Version
1
+ # Vacumify Model Context Protocol (MCP) Server
2
+
3
+ Connect **Vacumify** directly to AI agent environments such as **Claude Code**, **Claude Desktop**, **Cursor**, **Windsurf**, and **Google Antigravity**.
4
+
5
+ Let your AI agent inspect disk health, hunt for bloated dev caches (`node_modules`, `venv`, `bin`/`obj`), detect identical duplicate files via SHA-256 fingerprinting, and safely recycle clutter using Vacumify's parallel multi-core C# engine.
6
+
7
+ ---
8
+
9
+ ## Exposed MCP Tools
10
+
11
+ 1. **`vacumify_scan`**: Parallel multi-core scan of any directory. Returns total files, scanned bytes, duplicate groups, reclaimable duplicate bytes, and top heavy files.
12
+ 2. **`vacumify_get_dev_caches`**: Detects dormant developer artifact folders (`node_modules`, Python `venv`/`.venv`, Rust `target`, .NET `bin`/`obj`, Gradle) with sizes and project names without enumerating hundreds of thousands of subfiles.
13
+ 3. **`vacumify_get_safe_junk`**: Identifies 100% zero-risk safe junk: redundant duplicate copies (preserving copy #1 intact), obsolete downloads installers (>30d untouched), and crash dumps.
14
+ 4. **`vacumify_recycle_items`**: Safely moves specified files or folders to the **Windows Recycle Bin** (includes `dryRun: true` preview support).
15
+
16
+ ---
17
+
18
+ ## Configuration Guides
19
+
20
+ ### 1. Claude Desktop (`claude_desktop_config.json`)
21
+ ```json
22
+ {
23
+ "mcpServers": {
24
+ "vacumify": {
25
+ "command": "C:\\path\\to\\Vacumify.exe",
26
+ "args": ["--mcp"]
27
+ }
28
+ }
29
+ }
30
+ ```
31
+
32
+ ### 2. Claude Code (`~/.claude.json` or project `.claude.json`)
33
+ ```bash
34
+ claude mcp add vacumify -- C:\path\to\Vacumify.exe --mcp
35
+ ```
36
+
37
+ ### 3. Cursor IDE (`Settings > Features > MCP`)
38
+ - **Name**: `vacumify`
39
+ - **Type**: `command`
40
+ - **Command**: `C:\path\to\Vacumify.exe --mcp`
41
+
42
+ ### 4. Running via npx / Node wrapper
43
+ ```bash
44
+ # Set path or have Vacumify.exe in PATH:
45
+ set VACUMIFY_PATH=C:\path\to\Vacumify.exe
46
+ npx vacumify-mcp
47
+ ```
2
48
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
@@ -0,0 +1,98 @@
1
+ #!/usr/bin/env node
2
+
3
+ const { spawn, execSync } = require('child_process');
4
+ const fs = require('fs');
5
+ const path = require('path');
6
+
7
+ function findVacumifyExecutable() {
8
+ // 1. Explicit env variable
9
+ if (process.env.VACUMIFY_PATH && fs.existsSync(process.env.VACUMIFY_PATH)) {
10
+ return process.env.VACUMIFY_PATH;
11
+ }
12
+
13
+ // 2. Relative paths within the Vacumify repo
14
+ const candidates = [
15
+ path.resolve(__dirname, '../../StorageCleaner/StorageCleaner/bin/Release/net10.0-windows/win-x64/publish/Vacumify.exe'),
16
+ path.resolve(__dirname, '../../StorageCleaner/StorageCleaner/bin/Release/net10.0-windows/win-x64/Vacumify.exe'),
17
+ path.resolve(__dirname, '../../StorageCleaner/StorageCleaner/bin/Debug/net10.0-windows/Vacumify.exe'),
18
+ path.resolve(process.cwd(), 'Vacumify.exe')
19
+ ];
20
+
21
+ for (const cand of candidates) {
22
+ if (fs.existsSync(cand)) return cand;
23
+ }
24
+
25
+ // 3. Check ~/.vacumify auto-install directory
26
+ const userHome = process.env.USERPROFILE || process.env.HOME || '';
27
+ const autoInstallDir = path.join(userHome, '.vacumify');
28
+ const autoInstallExe = path.join(autoInstallDir, 'Vacumify.exe');
29
+ if (fs.existsSync(autoInstallExe)) return autoInstallExe;
30
+
31
+ // 4. Search PATH on Windows
32
+ if (process.platform === 'win32') {
33
+ try {
34
+ const stdout = execSync('where.exe Vacumify.exe', { stdio: ['pipe', 'pipe', 'ignore'], encoding: 'utf8' });
35
+ const firstLine = stdout.trim().split(/\r?\n/)[0];
36
+ if (firstLine && fs.existsSync(firstLine)) return firstLine;
37
+ } catch (_) {}
38
+ }
39
+
40
+ return null;
41
+ }
42
+
43
+ function downloadAndExtractRelease() {
44
+ if (process.platform !== 'win32') {
45
+ console.error('[vacumify-mcp] Vacumify currently supports Windows (x64).');
46
+ process.exit(1);
47
+ }
48
+
49
+ const userHome = process.env.USERPROFILE || process.env.HOME || '';
50
+ const autoInstallDir = path.join(userHome, '.vacumify');
51
+ const autoInstallExe = path.join(autoInstallDir, 'Vacumify.exe');
52
+ const url = 'https://github.com/kuroi17/Vacumify/releases/latest/download/Vacumify-win-x64.zip';
53
+
54
+ console.error('[vacumify-mcp] Vacumify.exe not found locally. Downloading latest release from GitHub...');
55
+
56
+ try {
57
+ if (!fs.existsSync(autoInstallDir)) fs.mkdirSync(autoInstallDir, { recursive: true });
58
+ const zipPath = path.join(autoInstallDir, 'Vacumify-win-x64.zip');
59
+
60
+ execSync(`powershell -Command "Invoke-WebRequest -Uri '${url}' -OutFile '${zipPath}'; Expand-Archive -Path '${zipPath}' -DestinationPath '${autoInstallDir}' -Force; Remove-Item '${zipPath}'"`, {
61
+ stdio: ['ignore', 'inherit', 'inherit']
62
+ });
63
+
64
+ if (fs.existsSync(autoInstallExe)) {
65
+ console.error('[vacumify-mcp] Successfully installed Vacumify to ' + autoInstallDir);
66
+ return autoInstallExe;
67
+ }
68
+ } catch (err) {
69
+ console.error('[vacumify-mcp] Auto-download failed: ' + err.message);
70
+ }
71
+ return null;
72
+ }
73
+
74
+ let exePath = findVacumifyExecutable() || downloadAndExtractRelease();
75
+
76
+ if (!exePath) {
77
+ console.error('[vacumify-mcp] Error: Vacumify.exe not found.');
78
+ console.error('[vacumify-mcp] Please either:');
79
+ console.error(' 1. Set VACUMIFY_PATH environment variable to the path of Vacumify.exe');
80
+ console.error(' 2. Place Vacumify.exe in your PATH');
81
+ console.error(' 3. Or build the project: dotnet publish StorageCleaner/StorageCleaner/StorageCleaner.csproj -c Release -r win-x64 --self-contained true');
82
+ process.exit(1);
83
+ }
84
+
85
+ const child = spawn(exePath, ['--mcp'], {
86
+ stdio: 'inherit',
87
+ windowsHide: true
88
+ });
89
+
90
+ child.on('error', (err) => {
91
+ console.error(`[vacumify-mcp] Failed to spawn Vacumify: ${err.message}`);
92
+ process.exit(1);
93
+ });
94
+
95
+ child.on('exit', (code, signal) => {
96
+ process.exit(code ?? (signal ? 1 : 0));
97
+ });
98
+
package/package.json CHANGED
@@ -1,6 +1,26 @@
1
- {
2
- "name": "vacumify-mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
1
+ {
2
+ "name": "vacumify-mcp",
3
+ "version": "1.0.0",
4
+ "description": "Model Context Protocol (MCP) server for Vacumify — Fast, local-first storage cleaner and duplicate finder for AI agents (Claude Code, Cursor, Antigravity, VS Code)",
5
+ "main": "bin/vacumify-mcp.js",
6
+ "bin": {
7
+ "vacumify-mcp": "bin/vacumify-mcp.js"
8
+ },
9
+ "keywords": [
10
+ "mcp",
11
+ "model-context-protocol",
12
+ "vacumify",
13
+ "disk-cleaner",
14
+ "duplicate-finder",
15
+ "storage",
16
+ "claude",
17
+ "cursor",
18
+ "ai-agent"
19
+ ],
20
+ "author": "kuroi17",
21
+ "license": "MIT",
22
+ "repository": {
23
+ "type": "git",
24
+ "url": "git+https://github.com/kuroi17/Vacumify.git"
25
+ }
26
+ }