unix-disk-mcp 0.2.0 → 0.4.0

package/README.md

@@ -95,6 +95,7 @@ unix-disk-mcp delete
 - `get_disk_usage` - Disk space overview
 - `find_large_items` - Find big files/folders (supports progressive depth exploration)
 - `get_item_info` - Details on specific paths
+- `search_files` - Find files/directories by name pattern
 
 **Discovery:**
 - `list_applications` - Installed apps with last-opened dates (macOS only)
@@ -147,4 +148,4 @@ unix-disk-mcp help     # Show help
 
 ## License
 
-MIT
+GPL-3.0-or-later

package/dist/commands/setup.js

@@ -17,11 +17,13 @@ const MCP_CONFIGS = {
             ? join(homedir(), "Library", "Application Support", "Code", "User", "mcp.json")
             : join(homedir(), ".config", "Code", "User", "mcp.json"),
     },
+    cursor: {
+        name: "Cursor",
+        path: join(homedir(), ".cursor", "mcp.json"),
+    },
     claude: {
         name: "Claude Desktop",
-        path: process.platform === 'darwin'
-            ? join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json")
-            : join(homedir(), ".config", "Claude", "claude_desktop_config.json"),
+        path: join(homedir(), ".claude.json"),
     },
 };
 /**
@@ -81,19 +83,22 @@ async function configureProtectedPaths(rl) {
 async function selectMCPClient(rl) {
     console.log("\n🔧 MCP Client Configuration\n");
     console.log("Which MCP client would you like to configure?\n");
-    console.log("  1. VS Code (Roo Cline)");
-    console.log("  2. Claude Desktop");
-    console.log("  3. Both");
-    console.log("  4. None (manual configuration)\n");
-    const answer = await ask(rl, "Select [1-4]: ");
+    console.log("  1. VS Code");
+    console.log("  2. Cursor");
+    console.log("  3. Claude Desktop");
+    console.log("  4. All of the above");
+    console.log("  5. None (manual configuration)\n");
+    const answer = await ask(rl, "Select [1-5]: ");
     switch (answer.trim()) {
         case "1":
             return "vscode";
         case "2":
-            return "claude";
+            return "cursor";
         case "3":
-            return "both";
+            return "claude";
         case "4":
+            return "all";
+        case "5":
         default:
             return "none";
     }
@@ -110,24 +115,24 @@ function updateMCPConfig(client, configPath) {
     try {
         const raw = readFileSync(config.path, "utf-8");
         const data = JSON.parse(raw);
-        if (client === "vscode") {
-            // VS Code MCP config format
-            if (!data.servers) {
-                data.servers = {};
+        if (client === "cursor") {
+            // Cursor format: uses "mcpServers" without "type"
+            if (!data.mcpServers) {
+                data.mcpServers = {};
             }
-            data.servers["unix-disk-mcp"] = {
-                type: "stdio",
+            data.mcpServers["unix-disk-mcp"] = {
                 command: "unix-disk-mcp",
+                args: [],
             };
         }
         else {
-            // Claude Desktop config format
-            if (!data.mcpServers) {
-                data.mcpServers = {};
+            // VS Code & Claude format: use "servers" with "type"
+            if (!data.servers) {
+                data.servers = {};
             }
-            data.mcpServers["unix-disk-mcp"] = {
+            data.servers["unix-disk-mcp"] = {
+                type: "stdio",
                 command: "unix-disk-mcp",
-                args: [],
             };
         }
         writeFileSync(config.path, JSON.stringify(data, null, 2));
@@ -166,8 +171,10 @@ function printManualInstructions() {
             args: [],
         },
     }, null, 2));
-    console.log("\n\nVS Code (Roo Cline):");
+    console.log("\n\nVS Code:");
     console.log(`  ${MCP_CONFIGS.vscode.path}\n`);
+    console.log("Cursor:");
+    console.log(`  ${MCP_CONFIGS.cursor.path}\n`);
     console.log("Claude Desktop:");
     console.log(`  ${MCP_CONFIGS.claude.path}\n`);
 }
@@ -191,10 +198,13 @@ export async function runSetup() {
             printManualInstructions();
         }
         else {
-            if (client === "vscode" || client === "both") {
+            if (client === "vscode" || client === "all") {
                 updateMCPConfig("vscode", getConfigPath());
             }
-            if (client === "claude" || client === "both") {
+            if (client === "cursor" || client === "all") {
+                updateMCPConfig("cursor", getConfigPath());
+            }
+            if (client === "claude" || client === "all") {
                 updateMCPConfig("claude", getConfigPath());
             }
             console.log("\n✅ Setup complete! Restart your MCP client to use the server.\n");

package/dist/server.js

@@ -5,7 +5,8 @@ import { registerStagingTools } from "./tools/staging.js";
 export function createServer(config) {
     const server = new McpServer({
         name: "unix-disk-mcp",
-        version: "0.1.0",
+        version: "0.4.0",
+        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.",
     });
     // Register all tools
     registerExplorationTools(server, config);

package/dist/tools/exploration.js

@@ -67,7 +67,7 @@ export function registerExplorationTools(server, config) {
         }
     });
     // get_disk_usage
-    server.tool("get_disk_usage", "Get overview of disk space usage", {}, async () => {
+    server.tool("get_disk_usage", "Get overview of disk space usage. **Use this first** when exploring disk usage to understand which filesystems/volumes need attention and get a breakdown of home directory space.", {}, async () => {
         try {
             let disk;
             if (process.platform === 'darwin') {
@@ -331,4 +331,97 @@ export function registerExplorationTools(server, config) {
             };
         }
     });
+    // search_files
+    server.tool("search_files", "Search for files and directories by name pattern. Use this to find all instances of an app, package, or file type across the system.", {
+        query: z.string().describe("Search query - can be exact name or pattern (e.g., 'Anki', 'node_modules', '*.mp4')"),
+        search_path: z.string().optional().describe("Starting directory (defaults to home directory)"),
+        max_results: z.number().optional().default(50).describe("Maximum number of results to return"),
+    }, async ({ query, search_path, max_results }) => {
+        try {
+            const startPath = search_path ? expandPath(search_path) : homedir();
+            let results = [];
+            if (process.platform === 'darwin') {
+                // macOS: Use mdfind (Spotlight) for fast searching
+                try {
+                    const mdfindCmd = search_path
+                        ? `mdfind -onlyin "${startPath}" -name "${query}"`
+                        : `mdfind -name "${query}"`;
+                    const output = execSync(mdfindCmd, {
+                        encoding: "utf-8",
+                        maxBuffer: 10 * 1024 * 1024, // 10MB buffer
+                    });
+                    results = output.trim().split("\n").filter(Boolean);
+                }
+                catch (error) {
+                    // Fall back to find if mdfind fails
+                    const findCmd = `find "${startPath}" -iname "*${query}*" 2>/dev/null`;
+                    const output = execSync(findCmd, {
+                        encoding: "utf-8",
+                        maxBuffer: 10 * 1024 * 1024,
+                    });
+                    results = output.trim().split("\n").filter(Boolean);
+                }
+            }
+            else {
+                // Linux: Use find
+                const findCmd = `find "${startPath}" -iname "*${query}*" 2>/dev/null`;
+                const output = execSync(findCmd, {
+                    encoding: "utf-8",
+                    maxBuffer: 10 * 1024 * 1024,
+                });
+                results = output.trim().split("\n").filter(Boolean);
+            }
+            // Limit results and get sizes
+            const limitedResults = results.slice(0, max_results);
+            const items = limitedResults.map(path => {
+                try {
+                    const stats = statSync(path);
+                    return {
+                        path,
+                        type: stats.isDirectory() ? "directory" : "file",
+                        size: stats.size,
+                        modified: stats.mtime.toISOString(),
+                    };
+                }
+                catch {
+                    return {
+                        path,
+                        type: "unknown",
+                        size: 0,
+                        error: "Could not read stats",
+                    };
+                }
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            data: {
+                                query,
+                                total_found: results.length,
+                                returned: items.length,
+                                items,
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : "Unknown error",
+                            code: "SEARCH_FILES_FAILED",
+                        }),
+                    },
+                ],
+            };
+        }
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unix-disk-mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "MCP server for AI-assisted disk cleanup on Unix systems (macOS and Linux)",
   "type": "module",
   "main": "dist/index.js",