@philau2512/fast-context-mcp 1.5.4 → 1.5.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@philau2512/fast-context-mcp",
-  "version": "1.5.4",
+  "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;
@@ -91,16 +95,23 @@ export function buildFastContextSearchTool({
   const runSearchWithContent = deps.searchWithContent || searchWithContent;
   const validatePath = deps.validateProjectPath || validateProjectPath;
   const description =
-    "Fast semantic codebase search and context discovery. " +
-    "Locates relevant files, exact line ranges, and code regions from natural language descriptions in a single step, " +
+    "Primary tool for semantic codebase search, context discovery, and verifying logic existence. " +
+    "Locates relevant files, exact line ranges, and code regions from natural language or domain concepts in a single step, " +
     "without needing manual grep trials or knowing exact filenames.\n\n" +
-    "Recommended for:\n" +
-    "- Finding feature implementations, business logic, and API flows (e.g. 'where is payment webhook handled', 'auth token refresh flow').\n" +
-    "- Exploring unfamiliar codebases or locating where conceptual logic lives.\n" +
-    "- Getting high-relevance entry points, line ranges, and suggested grep keywords before reading code.\n\n" +
-    "Use exact-match grep instead only when searching for a known, specific symbol name or literal string.\n\n" +
-    "For best semantic search quality, write the query primarily in English; add local-language business terms only when needed.\n" +
-    "Use tree_depth/max_turns/max_results for task-level tuning; use exclude_paths to reduce payload or noise.\n" +
+    "MANDATORY REQUIREMENT:\n" +
+    "- 'project_path' is strictly REQUIRED. You MUST provide the absolute path to the project root directory when calling this tool.\n\n" +
+    "RECOMMENDED FOR:\n" +
+    "- Verifying feature/data existence: Checking whether a business rule, model, seed data, configuration, or API already exists (e.g. 'check if warrior coefficient seed data exists', 'has rate limiting been added').\n" +
+    "- Finding conceptual business logic: Locating where behavior lives across the codebase without guessing file names.\n" +
+    "- Tracing multi-file flows: Getting high-relevance entry points, line ranges, and suggested grep keywords before reading code.\n\n" +
+    "DO NOT USE WHEN (Avoid Overuse):\n" +
+    "- Target file is already known, opened, or specified by the user (use view_file / read_file directly).\n" +
+    "- Exact symbol search: Searching for an exact, known function/class/variable name (use grep instead).\n" +
+    "- Directory exploration: Simply listing files in a directory (use list_dir/glob instead).\n" +
+    "- Single-file localized edits or lint fixes.\n\n" +
+    "QUERY TIPS:\n" +
+    "- For best semantic search quality, write the query primarily in English; keep local-language domain terms when needed (e.g. 'seed data for sale he so chien binh').\n" +
+    "- Use tree_depth/max_turns/max_results for task-level tuning; use exclude_paths to reduce payload or noise.\n" +
     (config.includeSnippetsExplicitlySet
       ? `- include_code_snippets: Server-configured default is ${config.includeSnippets}. Do NOT override unless explicitly asked by the user.\n`
       : "- include_code_snippets: Default false (lightweight mode, ~2-5KB output). " +
@@ -115,8 +126,9 @@ export function buildFastContextSearchTool({
       'Add local-language business terms only when needed.'
     ),
     project_path: projectPathSchema.describe(
-      "Absolute path to project root directory (required). " +
-      "Example: /Users/username/projects/myproject or C:/Users/username/projects/myproject"
+      "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()
@@ -184,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 }] };