cf-memory-mcp 3.8.6 → 3.8.8

package/bin/cf-memory-mcp.js

@@ -155,7 +155,7 @@ const TOOLS_LIST = [
                 file_filter: { type: 'array', items: { type: 'string' }, description: 'Limit to files matching path substrings' },
                 all_projects: { type: 'boolean', description: 'Search across ALL your indexed projects (overrides project_id). Useful for "find X in any of my repos".' },
                 expand_context: { type: 'boolean', description: 'Include file_imports (the file\'s module/imports chunk) with each result. Default: true.' },
-                exclude_docs: { type: 'boolean', description: 'Filter out markdown/docs from code queries. Default: true (auto-disabled if query mentions docs/readme/tutorial).' }
+                exclude_docs: { type: 'boolean', description: 'Filter out markdown/docs from code queries. Default: true (auto-disabled if query mentions docs/readme/tutorial). Response includes docs_filtered_count when chunks were dropped — flip to false to surface them.' }
             },
             required: ['query']
         }
@@ -1084,6 +1084,13 @@ class CFMemoryMCP {
             this.logDebug(`Found ${files.length} files to index.`);
 
             if (files.length === 0) {
+                // Verify the path actually exists so we can tell the user
+                // whether it's "path wrong" or "everything was filtered out".
+                let pathExists = false;
+                try { pathExists = fs.existsSync(resolvedPath); } catch (_) { pathExists = false; }
+                const hint = !pathExists
+                    ? `Path "${resolvedPath}" does not exist. Check the project_path argument.`
+                    : `Path exists but every file was filtered out. The bridge excludes node_modules, dist, build, .git, *.lock, *.min.js, *.d.ts, .augment, .kiro, .intent, .husky, .claude, and generated/ directories. Pass include_patterns to override, or check that the project actually has source files at this path.`;
                 const response = {
                     jsonrpc: '2.0',
                     id: message.id,
@@ -1097,7 +1104,8 @@ class CFMemoryMCP {
                                 files_indexed: 0,
                                 chunks_created: 0,
                                 status: 'complete',
-                                message: 'No matching files found in directory'
+                                message: 'No matching files found in directory',
+                                hint
                             }, null, 2)
                         }]
                     }
@@ -1695,13 +1703,19 @@ class CFMemoryMCP {
                         const response = JSON.parse(body);
                         resolve(response);
                     } catch (error) {
+                        // Include HTTP status + body snippet so callers can
+                        // see whether they got a 404, a Cloudflare HTML error
+                        // page, or some other non-JSON response. Without this,
+                        // "Invalid JSON" alone hides whether the worker is
+                        // even reachable.
+                        const bodyPreview = body.slice(0, 200).replace(/\s+/g, ' ');
                         resolve({
                             jsonrpc: '2.0',
                             id: message.id || null,
                             error: {
                                 code: -32603,
-                                message: 'Invalid JSON response from server',
-                                data: error.message
+                                message: `Invalid JSON response from server (HTTP ${res.statusCode})`,
+                                data: `${error.message}; body[0..200]=${bodyPreview}`
                             }
                         });
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cf-memory-mcp",
-	"version": "3.8.6",
+	"version": "3.8.8",
 	"description": "Cloudflare-hosted MCP server for code indexing, retrieval, and assistant memory with a direct remote MCP endpoint and local stdio bridge.",
 	"main": "bin/cf-memory-mcp.js",
 	"bin": {