rag-memory-pg-mcp 2.1.1 → 2.2.1

package/.github/workflows/security-check.yml

@@ -23,7 +23,7 @@ jobs:
           echo "🔍 Scanning for potential secrets..."
           
           # Check for API keys
-          if grep -r "sk-proj-" --exclude-dir=node_modules --exclude-dir=.git . ; then
+          if grep -rE "(sk-proj-[A-Za-z0-9]{20,}|sk-[A-Za-z0-9]{20,})" --exclude-dir=node_modules --exclude-dir=.git . ; then
             echo "❌ Found OpenAI API key!"
             exit 1
           fi

package/CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.1] - 2026-01-08
+
+### Fixed 🐛
+- **hybridSearch syntax error** - queries with spaces/special characters no longer fail
+- **getDetailedContext syntax error** - same fix applied
+- Root cause: `textSearch()` used `to_tsquery()` which requires special syntax (`'word1' & 'word2'`)
+- Solution: Added `type: 'websearch'` option to use `websearch_to_tsquery()` instead
+
+### Improved
+- hybridSearch now supports advanced query syntax:
+  - Plain text: `authentication jwt` (AND search)
+  - Exact phrases: `"user authentication"`
+  - OR operator: `auth OR login`
+  - Negation: `react -native`
+
+## [2.2.0] - 2026-01-05
+
+### Breaking Changes 🔴
+- **Renamed `readGraph` → `getGraph`** due to Cursor API conflict
+- The `readGraph` name was causing the tool to be ignored/blocked by Cursor
+- Handler supports both names for backward compatibility
+
+### Fixed 🐛
+- **Tool loading in CLIENT mode** - now correctly shows 10 tools (was showing 9)
+- Root cause: `readGraph` conflicted with Cursor internal API
+- Solution: Renamed to `getGraph` - all tools now load properly
+
+### Technical Details
+- Debug analysis showed server was sending 10 tools correctly
+- Cursor was blocking/ignoring the `readGraph` tool during registration
+- Tool name conflict resolved by renaming
+
 ## [2.1.1] - 2026-01-05
 
 ### Added ✨

package/README.md

@@ -196,7 +196,7 @@ npm install -g github:kshidenko/rag-memory-pg-mcp
 - Knowledge Graph: createEntities, createRelations, addObservations, searchNodes, openNodes
 - Documents: processDocument (⭐ main tool)
 - Search: hybridSearch, getDetailedContext
-- Info: readGraph, getKnowledgeGraphStats
+- Info: getGraph, getKnowledgeGraphStats
 
 **MAINTENANCE mode (11 tools) - For cleanup and admin:**
 - Cleanup: deleteEntities, deleteRelations, deleteObservations, deleteDocuments

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rag-memory-pg-mcp",
-  "version": "2.1.1",
+  "version": "2.2.1",
   "description": "PostgreSQL-based RAG Memory MCP Server with Supabase - knowledge graph + semantic search",
   "type": "module",
   "main": "src/index.js",

package/src/handlers.js

@@ -102,7 +102,8 @@ async function executeToolMethod(name, args, manager) {
         includeEntities: args.includeEntities,
       });
 
-    case 'readGraph':
+    case 'getGraph':
+    case 'readGraph': // Backward compatibility
       return manager.readGraph();
 
     // ==================== UTILITIES ====================

package/src/index.js

@@ -62,7 +62,7 @@ console.error(`📊 Active tools: ${activeTools.length}/${allTools.length}`);
 const server = new Server(
   {
     name: 'rag-memory-pg',
-    version: '2.1.1',
+    version: '2.2.0',
     description: 'RAG-enabled memory with PostgreSQL/Supabase backend. Provides knowledge graph, document management, and semantic search. All content should be in English for optimal performance.',
     instructions: `This is a RAG (Retrieval-Augmented Generation) memory system with knowledge graph capabilities.
 

package/src/manager.js

@@ -736,15 +736,34 @@ export class RAGKnowledgeGraphManager {
   /**
    * Hybrid search (semantic + text)
    * 
-   * @param {string} query - Search query
+   * Uses websearch_to_tsquery for safe query parsing that handles:
+   * - Plain text with spaces
+   * - Quoted phrases ("exact match")
+   * - OR operator
+   * - Negation with -
+   * 
+   * @param {string} query - Search query (plain text or websearch syntax)
    * @param {number} limit - Max results
    * @returns {object[]} Search results
+   * 
+   * @example
+   * // Simple search
+   * hybridSearch('authentication jwt')
+   * 
+   * // Phrase search
+   * hybridSearch('"user authentication"')
+   * 
+   * // With OR
+   * hybridSearch('auth OR login')
    */
   async hybridSearch(query, limit = 5) {
     const { data, error } = await this.supabase
       .from('rag_documents')
       .select('id, content, metadata, created_at')
-      .textSearch('content', query)
+      .textSearch('content', query, {
+        type: 'websearch',
+        config: 'english'
+      })
       .limit(limit);
     
     if (error) throw new Error(error.message);
@@ -768,7 +787,10 @@ export class RAGKnowledgeGraphManager {
     const { data: docs } = await this.supabase
       .from('rag_documents')
       .select('id, content, metadata')
-      .textSearch('content', query)
+      .textSearch('content', query, {
+        type: 'websearch',
+        config: 'english'
+      })
       .limit(limit);
 
     if (docs) results.documents = docs;

package/src/tool-modes.js

@@ -27,7 +27,7 @@ export const TOOL_MODES = {
     'getDetailedContext',  // Get rich context with entities
     
     // Utilities - Basic info
-    'readGraph',           // View knowledge graph
+    'getGraph',            // View knowledge graph (renamed from readGraph)
     'getKnowledgeGraphStats', // See statistics
   ],
 

package/src/tools.js

@@ -13,7 +13,7 @@
  * @returns {object[]} Array of tool definitions
  */
 export function getToolDefinitions() {
-  return [
+  const tools = [
     // ==================== ENTITY TOOLS ====================
     {
       name: 'createEntities',
@@ -297,7 +297,7 @@ export function getToolDefinitions() {
     },
     {
       name: 'embedAllEntities',
-      description: 'Generate embeddings for all entities',
+      description: 'Generate embeddings for all entities in the knowledge graph. Use this to enable semantic search on entities or after adding many new entities. No parameters required.',
       inputSchema: {
         type: 'object',
         properties: {},
@@ -349,23 +349,21 @@ export function getToolDefinitions() {
       },
     },
     {
-      name: 'readGraph',
-      description: 'Read the entire knowledge graph with all entities, relationships, and observations. Use this to get a complete overview of stored knowledge. Returns full graph structure for analysis or visualization.',
+      name: 'getGraph',
+      description: 'Get the entire knowledge graph with all entities, relationships, and observations. Use this to retrieve complete overview of stored knowledge. Returns full graph structure for analysis or visualization. No parameters required.',
       inputSchema: {
         type: 'object',
         properties: {},
-        description: 'No parameters required. Returns complete graph with all entities and their connections.'
       },
     },
 
     // ==================== UTILITY TOOLS ====================
     {
       name: 'getKnowledgeGraphStats',
-      description: 'Get statistics about the knowledge graph including total counts of entities, relationships, documents, and chunks. Use this to understand the size and scope of stored knowledge.',
+      description: 'Get statistics about the knowledge graph including total counts of entities, relationships, documents, and chunks. Use this to understand the size and scope of stored knowledge. Returns entity_count, relationship_count, document_count, chunk_count, and type distributions. No parameters required.',
       inputSchema: {
         type: 'object',
         properties: {},
-        description: 'No parameters required. Returns entity_count, relationship_count, document_count, chunk_count, and type distributions.'
       },
     },
     {
@@ -394,4 +392,6 @@ export function getToolDefinitions() {
       },
     },
   ];
+  
+  return tools;
 }