@philau2512/fast-context-mcp 1.5.5 → 1.5.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@philau2512/fast-context-mcp",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "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,43 +1,61 @@
 import { statSync } from "node:fs";
-import { isAbsolute } from "node:path";
+import { isAbsolute, resolve } from "node:path";
 import { z } from "zod";
 
 export const PROJECT_PATH_REQUIRED_MESSAGE =
-  "project_path is required. Pass the absolute path to the project root directory.";
+  "project_path is optional. Pass the absolute or relative path to the project root directory, or omit to use current working directory.";
 
 export const projectPathSchema = z
   .string()
   .trim()
-  .min(1, PROJECT_PATH_REQUIRED_MESSAGE);
+  .nullish()
+  .transform((val) => val ?? "")
+  .default("");
+
+/**
+ * Resolve project path to an absolute path.
+ * If empty, null, or ".", defaults to cwd (process.cwd()).
+ * If relative, resolves against cwd.
+ *
+ * @param {string|null|undefined} projectPath
+ * @param {string} [cwd]
+ * @returns {string}
+ */
+export function resolveProjectPath(projectPath, cwd = process.cwd()) {
+  const trimmed = typeof projectPath === "string" ? projectPath.trim() : "";
+  if (!trimmed || trimmed === "." || trimmed === "./" || trimmed === ".\\") {
+    return cwd;
+  }
+  if (isAbsolute(trimmed)) {
+    return trimmed;
+  }
+  return resolve(cwd, trimmed);
+}
 
 /**
  * Validate the project root path provided to fast_context_search.
+ * Automatically resolves relative paths or empty/omitted paths against cwd.
  * Returns null when valid, otherwise an MCP-friendly error string.
  *
  * @param {string} projectPath
  * @param {(path: string) => import("node:fs").Stats} [statFn]
+ * @param {string} [cwd]
  * @returns {string|null}
  */
-export function validateProjectPath(projectPath, statFn = statSync) {
-  if (!projectPath) {
-    return `Error: ${PROJECT_PATH_REQUIRED_MESSAGE}`;
-  }
-
-  if (!isAbsolute(projectPath)) {
-    return `Error: project_path must be an absolute path, got: ${projectPath}`;
-  }
+export function validateProjectPath(projectPath, statFn = statSync, cwd = process.cwd()) {
+  const resolved = resolveProjectPath(projectPath, cwd);
 
   try {
-    const st = statFn(projectPath);
+    const st = statFn(resolved);
     if (!st.isDirectory()) {
-      return `Error: project_path is not a directory: ${projectPath}`;
+      return `Error: project_path is not a directory: ${resolved}`;
     }
   } catch (error) {
     if (error?.code === "ENOENT") {
-      return `Error: project_path does not exist: ${projectPath}`;
+      return `Error: project_path does not exist: ${resolved}`;
     }
     if (error?.code === "EACCES" || error?.code === "EPERM") {
-      return `Error: cannot access project_path (${error.code}): ${projectPath}`;
+      return `Error: cannot access project_path (${error.code}): ${resolved}`;
     }
     const reason = error?.message ? `${error.code || "UNKNOWN"}: ${error.message}` : String(error);
     return `Error: failed to validate project_path: ${reason}`;

package/src/server.mjs

@@ -22,7 +22,11 @@ import { fileURLToPath } from "node:url";
 import { z } from "zod";
 
 import { searchWithContent, extractKeyInfo } from "./core.mjs";
-import { projectPathSchema, validateProjectPath } from "./project-path.mjs";
+import {
+  projectPathSchema,
+  resolveProjectPath,
+  validateProjectPath,
+} from "./project-path.mjs";
 
 const PACKAGE_JSON = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 export const SERVER_VERSION = PACKAGE_JSON.version;
@@ -122,9 +126,9 @@ 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."
+      "Optional path to project root directory (absolute or relative). " +
+      "Defaults to current workspace directory if omitted. " +
+      "Example: /Users/username/projects/myproject or C:/Users/username/projects/myproject or ."
     ),
     tree_depth: z
       .number()
@@ -192,7 +196,7 @@ export function buildFastContextSearchTool({
     exclude_paths,
     include_code_snippets,
   }) => {
-    const projectPath = project_path;
+    const projectPath = resolveProjectPath(project_path);
     const validationError = validatePath(projectPath);
     if (validationError) {
       return { content: [{ type: "text", text: validationError }] };