@philau2512/fast-context-mcp 1.5.5 → 1.5.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@philau2512/fast-context-mcp",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "AI-driven semantic code search MCP server (Node.js) — Windsurf/Devin protocol",
   "type": "module",
   "main": "src/server.mjs",
@@ -53,4 +53,4 @@
     "access": "public"
   },
   "license": "MIT"
-}
+}

package/src/project-path.mjs

@@ -1,5 +1,6 @@
 import { statSync } from "node:fs";
-import { isAbsolute } from "node:path";
+import { homedir } from "node:os";
+import { isAbsolute, normalize } from "node:path";
 import { z } from "zod";
 
 export const PROJECT_PATH_REQUIRED_MESSAGE =
@@ -10,6 +11,28 @@ export const projectPathSchema = z
   .trim()
   .min(1, PROJECT_PATH_REQUIRED_MESSAGE);
 
+/**
+ * Check if a path points to the user's home directory or system root.
+ * @param {string} p
+ * @returns {boolean}
+ */
+export function isHomeOrRootDir(p) {
+  if (!p || typeof p !== "string") return false;
+  const trimmed = p.trim();
+  if (trimmed === "/" || trimmed === "\\" || /^[a-zA-Z]:[\\/]*$/.test(trimmed)) {
+    return true;
+  }
+  const norm = normalize(trimmed).replace(/[\\/]+$/, "");
+  const home = normalize(homedir()).replace(/[\\/]+$/, "");
+  if (norm.toLowerCase() === home.toLowerCase()) {
+    return true;
+  }
+  if (/^[a-zA-Z]:$/.test(norm) || norm === "" || norm === "/" || norm === "\\") {
+    return true;
+  }
+  return false;
+}
+
 /**
  * Validate the project root path provided to fast_context_search.
  * Returns null when valid, otherwise an MCP-friendly error string.
@@ -27,6 +50,10 @@ export function validateProjectPath(projectPath, statFn = statSync) {
     return `Error: project_path must be an absolute path, got: ${projectPath}`;
   }
 
+  if (isHomeOrRootDir(projectPath)) {
+    return `Error: project_path cannot be the user home directory or system root: ${projectPath}. Please provide the specific workspace path (e.g. 'C:/PROJECTS/my-app').`;
+  }
+
   try {
     const st = statFn(projectPath);
     if (!st.isDirectory()) {

package/src/server.mjs

@@ -122,9 +122,8 @@ export function buildFastContextSearchTool({
       'Add local-language business terms only when needed.'
     ),
     project_path: projectPathSchema.describe(
-      "MANDATORY: Absolute path to project root directory (required). " +
-      "You MUST supply this parameter explicitly on every call (e.g. /Users/username/projects/myproject or C:/Users/username/projects/myproject). " +
-      "Never leave empty or omit."
+      "Absolute path to the project root directory (REQUIRED). " +
+      "Pass the active workspace directory from your session context (e.g. 'C:/PROJECTS/myproject' or '/Users/name/projects/myproject')."
     ),
     tree_depth: z
       .number()