unix-disk-mcp 0.4.0 → 0.4.1
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 +25 -11
- package/config.sample.json +1 -6
- package/dist/config/index.d.ts +0 -3
- package/dist/server.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -13,11 +13,15 @@ Traditional disk cleaners use fixed rules. This tool lets AI *reason* about your
|
|
|
13
13
|
## Security
|
|
14
14
|
|
|
15
15
|
The AI **cannot delete files**. Ever. This is architectural:
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
16
|
+
|
|
17
|
+
**What AI can do:**
|
|
18
|
+
- Explore filesystem
|
|
19
|
+
- Suggest items to delete
|
|
20
|
+
- Stage items for deletion
|
|
21
|
+
|
|
22
|
+
**What AI cannot do:**
|
|
23
|
+
- Execute deletion
|
|
24
|
+
- Run delete script
|
|
21
25
|
|
|
22
26
|
You run `unix-disk-mcp delete` manually to review and confirm.
|
|
23
27
|
|
|
@@ -32,7 +36,7 @@ The setup wizard configures everything. Or manually:
|
|
|
32
36
|
|
|
33
37
|
**1. Add to MCP client config:**
|
|
34
38
|
|
|
35
|
-
VS Code:
|
|
39
|
+
VS Code: `~/Library/Application Support/Code/User/mcp.json` (macOS) or `~/.config/Code/User/mcp.json` (Linux)
|
|
36
40
|
```json
|
|
37
41
|
{
|
|
38
42
|
"servers": {
|
|
@@ -44,11 +48,24 @@ VS Code: `~/.config/Code/User/mcp.json` (Linux) or `~/Library/Application Suppor
|
|
|
44
48
|
}
|
|
45
49
|
```
|
|
46
50
|
|
|
47
|
-
|
|
51
|
+
Cursor: `~/.cursor/mcp.json`
|
|
48
52
|
```json
|
|
49
53
|
{
|
|
50
54
|
"mcpServers": {
|
|
51
55
|
"unix-disk-mcp": {
|
|
56
|
+
"command": "unix-disk-mcp",
|
|
57
|
+
"args": []
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Claude: `~/.claude.json`
|
|
64
|
+
```json
|
|
65
|
+
{
|
|
66
|
+
"servers": {
|
|
67
|
+
"unix-disk-mcp": {
|
|
68
|
+
"type": "stdio",
|
|
52
69
|
"command": "unix-disk-mcp"
|
|
53
70
|
}
|
|
54
71
|
}
|
|
@@ -60,10 +77,7 @@ Claude Desktop: `~/.config/Claude/claude_desktop_config.json` (Linux) or `~/Libr
|
|
|
60
77
|
Run `unix-disk-mcp config` to see config location, then edit:
|
|
61
78
|
```json
|
|
62
79
|
{
|
|
63
|
-
"protected_paths": ["/System", "/Library", "~/.ssh", "~/.gnupg"]
|
|
64
|
-
"ignore_patterns": [".git"],
|
|
65
|
-
"max_delete_size_gb": 10,
|
|
66
|
-
"dry_run": false
|
|
80
|
+
"protected_paths": ["/System", "/Library", "~/.ssh", "~/.gnupg"]
|
|
67
81
|
}
|
|
68
82
|
```
|
|
69
83
|
|
package/config.sample.json
CHANGED
package/dist/config/index.d.ts
CHANGED
package/dist/server.js
CHANGED
|
@@ -5,7 +5,7 @@ import { registerStagingTools } from "./tools/staging.js";
|
|
|
5
5
|
export function createServer(config) {
|
|
6
6
|
const server = new McpServer({
|
|
7
7
|
name: "unix-disk-mcp",
|
|
8
|
-
version: "0.4.
|
|
8
|
+
version: "0.4.1",
|
|
9
9
|
description: "AI-assisted disk cleanup for Unix systems. **Recommended workflow:** 1) Start with get_disk_usage for overview 2) Use search_files or find_large_items to identify targets 3) Stage items for deletion 4) User executes deletion manually. You can explore but never delete files.",
|
|
10
10
|
});
|
|
11
11
|
// Register all tools
|