domain-rag-mcp-server 3.1.0 → 3.1.1

package/dist/index.mjs

@@ -842,59 +842,13 @@ async function initPostgres() {
 }
 var tools = [
   // ============================================
-  // Server Code Search Tools (HIGHEST PRIORITY)
-  // Direct search on server filesystem repositories
-  // ============================================
-  {
-    name: "search_server_code",
-    description: "HIGHEST PRIORITY - Search source code on the server. Searches across all indexed repositories. Use for finding implementations, classes, functions, or any code patterns. Much faster than vector search for exact matches.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        query: {
-          type: "string",
-          description: "Search query - code pattern, class name, function, or text to find"
-        },
-        mode: {
-          type: "string",
-          enum: ["content", "filename"],
-          description: 'Search mode: "content" for grep-like search in file contents, "filename" for file name pattern matching',
-          default: "content"
-        },
-        repos: {
-          type: "array",
-          items: { type: "string" },
-          description: 'Filter by repository names (optional). Example: ["frontend", "backend"]'
-        },
-        extensions: {
-          type: "array",
-          items: { type: "string" },
-          description: 'File extensions to search (optional). Example: [".ts", ".cs"]'
-        },
-        limit: {
-          type: "number",
-          description: "Maximum results (default: 20)",
-          default: 20
-        }
-      },
-      required: ["query"]
-    }
-  },
-  {
-    name: "list_server_repos",
-    description: "List all source code repositories available on the server for code search.",
-    inputSchema: {
-      type: "object",
-      properties: {}
-    }
-  },
-  // ============================================
-  // PostgreSQL Structured Search Tools (High Priority)
+  // PostgreSQL Structured Search Tools (HIGHEST PRIORITY)
   // These provide SQL-based search with structured data
+  // Lightweight, fast, and context-friendly
   // ============================================
   {
     name: "search_structured",
-    description: "HIGHEST PRIORITY - Search structured Jira/Confluence data in PostgreSQL. Returns well-organized results with full metadata. Use this first for any business or documentation queries.",
+    description: "HIGHEST PRIORITY - Search structured Jira/Confluence data in PostgreSQL. Returns well-organized results with full metadata. Use this FIRST for any business or documentation queries. Lightweight and context-friendly.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1234,6 +1188,56 @@ var tools = [
       type: "object",
       properties: {}
     }
+  },
+  // ============================================
+  // Server Code Search Tools (LOW PRIORITY - use last)
+  // Direct grep on server filesystem repositories
+  // WARNING: Returns large responses that consume context window.
+  // Prefer search_as_architect, search_structured, or search_knowledge first.
+  // Only use this for targeted lookups (exact class name, specific file).
+  // ============================================
+  {
+    name: "search_server_code",
+    description: "LOW PRIORITY - Direct grep search on server source code repositories. WARNING: returns large responses that consume AI context window quickly. Use search_as_architect or search_structured FIRST. Only use this tool as a LAST RESORT for targeted lookups when you need exact code matches (specific class name, function signature, or file) and other tools did not return enough detail. Always specify repos[] filter and keep limit low (5-10).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "Search query - code pattern, class name, function, or text to find"
+        },
+        mode: {
+          type: "string",
+          enum: ["content", "filename"],
+          description: 'Search mode: "content" for grep-like search in file contents, "filename" for file name pattern matching',
+          default: "content"
+        },
+        repos: {
+          type: "array",
+          items: { type: "string" },
+          description: 'Filter by repository names (RECOMMENDED to reduce response size). Example: ["frontend", "backend"]'
+        },
+        extensions: {
+          type: "array",
+          items: { type: "string" },
+          description: 'File extensions to search (optional). Example: [".ts", ".cs"]'
+        },
+        limit: {
+          type: "number",
+          description: "Maximum results (default: 10, keep low to avoid context overflow)",
+          default: 10
+        }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "list_server_repos",
+    description: "List all source code repositories available on the server for code search.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
   }
 ];
 async function handleSearchServerCode(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domain-rag-mcp-server",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "MCP server for domain RAG search — connects to Qdrant + PostgreSQL + Code Search API for hybrid search across Jira, Confluence, Git commits, and server-side code repositories",
   "type": "module",
   "main": "dist/index.mjs",