domain-rag-mcp-server 3.1.0 → 3.2.0

package/dist/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// src/index.ts
+// ../domain-rag-system/mcp-server/src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -10,7 +10,7 @@ import {
 import { QdrantClient } from "@qdrant/js-client-rest";
 import { v4 as uuidv4 } from "uuid";
 
-// ../shared/src/config.ts
+// ../domain-rag-system/shared/src/config.ts
 import { config as dotenvConfig } from "dotenv";
 import { existsSync } from "fs";
 import { join } from "path";
@@ -240,7 +240,7 @@ function getSourceWeightsMap() {
   };
 }
 
-// ../shared/src/embeddings/types.ts
+// ../domain-rag-system/shared/src/embeddings/types.ts
 var BaseEmbeddingProvider = class {
   /**
    * Default batch implementation - calls getEmbedding sequentially
@@ -256,7 +256,7 @@ var BaseEmbeddingProvider = class {
   }
 };
 
-// ../shared/src/embeddings/ollama.ts
+// ../domain-rag-system/shared/src/embeddings/ollama.ts
 var OllamaProvider = class extends BaseEmbeddingProvider {
   name = "ollama";
   dimensions;
@@ -320,7 +320,7 @@ var OllamaProvider = class extends BaseEmbeddingProvider {
   }
 };
 
-// ../shared/src/embeddings/openai.ts
+// ../domain-rag-system/shared/src/embeddings/openai.ts
 var OpenAIProvider = class extends BaseEmbeddingProvider {
   name = "openai";
   dimensions;
@@ -405,7 +405,7 @@ var OpenAIProvider = class extends BaseEmbeddingProvider {
   }
 };
 
-// ../shared/src/embeddings/factory.ts
+// ../domain-rag-system/shared/src/embeddings/factory.ts
 function createEmbeddingProvider() {
   const providerType = config.embeddings.provider;
   switch (providerType) {
@@ -436,7 +436,7 @@ function getEmbeddingProvider() {
   return _provider;
 }
 
-// ../shared/src/postgres/client.ts
+// ../domain-rag-system/shared/src/postgres/client.ts
 import pg from "pg";
 var { Pool } = pg;
 var pool = null;
@@ -484,7 +484,7 @@ async function checkHealth() {
   }
 }
 
-// ../shared/src/postgres/search.ts
+// ../domain-rag-system/shared/src/postgres/search.ts
 async function searchAll(searchQuery, options = {}) {
   const { limit = 30, sources } = options;
   const includeJira = !sources || sources.includes("jira");
@@ -737,7 +737,7 @@ async function getStats() {
   };
 }
 
-// src/index.ts
+// ../domain-rag-system/mcp-server/src/index.ts
 var SOURCE_WEIGHTS = getSourceWeightsMap();
 var qdrant = new QdrantClient({
   url: config.qdrant.url,
@@ -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: {
@@ -1034,6 +988,25 @@ var tools = [
       properties: {}
     }
   },
+  {
+    name: "raw_sql",
+    description: "Execute a raw SQL SELECT query on PostgreSQL database. ONLY SELECT queries are allowed. Use for complex queries that other tools cannot handle. Tables: persons, jira_projects, jira_issues, confluence_spaces, confluence_pages, git_commits, jira_issue_commits.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sql: {
+          type: "string",
+          description: "SQL SELECT query to execute. Example: SELECT issue_key, summary FROM jira_issues WHERE status = 'Done' LIMIT 10"
+        },
+        params: {
+          type: "array",
+          items: { type: "string" },
+          description: "Query parameters for parameterized queries (optional). Use $1, $2, etc. in SQL."
+        }
+      },
+      required: ["sql"]
+    }
+  },
   // ============================================
   // Vector Search Tools (Qdrant)
   // ============================================
@@ -1234,6 +1207,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) {
@@ -1565,6 +1588,59 @@ async function handleGetDbStats() {
   }
   return response;
 }
+async function handleRawSql(args) {
+  if (!pgAvailable) {
+    return "PostgreSQL not available.";
+  }
+  const normalizedSql = args.sql.trim().toLowerCase();
+  if (!normalizedSql.startsWith("select")) {
+    return "Error: Only SELECT queries are allowed. Use SELECT to query data.";
+  }
+  const dangerousKeywords = ["insert", "update", "delete", "drop", "truncate", "alter", "create", "grant", "revoke"];
+  for (const keyword of dangerousKeywords) {
+    if (normalizedSql.includes(keyword)) {
+      return `Error: Query contains forbidden keyword "${keyword}". Only SELECT queries are allowed.`;
+    }
+  }
+  try {
+    const result = await query(args.sql, args.params);
+    if (result.rows.length === 0) {
+      return "Query returned no results.";
+    }
+    const columns = Object.keys(result.rows[0]);
+    let response = `## Query Results
+
+`;
+    response += `Rows: ${result.rows.length}
+
+`;
+    response += "| " + columns.join(" | ") + " |\n";
+    response += "|" + columns.map(() => "---").join("|") + "|\n";
+    const maxRows = Math.min(result.rows.length, 100);
+    for (let i = 0; i < maxRows; i++) {
+      const row = result.rows[i];
+      const values = columns.map((col) => {
+        const val = row[col];
+        if (val === null)
+          return "NULL";
+        if (typeof val === "object")
+          return JSON.stringify(val).substring(0, 100);
+        const str = String(val);
+        return str.length > 100 ? str.substring(0, 100) + "..." : str;
+      });
+      response += "| " + values.join(" | ") + " |\n";
+    }
+    if (result.rows.length > 100) {
+      response += `
+*Showing first 100 of ${result.rows.length} rows*
+`;
+    }
+    return response;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    return `SQL Error: ${message}`;
+  }
+}
 async function handleSearchAsAnalyst(args) {
   const results = await searchWithWeights({
     query: args.query,
@@ -1777,6 +1853,9 @@ async function main() {
         case "get_db_stats":
           result = await handleGetDbStats();
           break;
+        case "raw_sql":
+          result = await handleRawSql(args);
+          break;
         case "search_as_analyst":
           result = await handleSearchAsAnalyst(args);
           break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domain-rag-mcp-server",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "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",