feat: mcp config generator and docs

README.md

@@ -9,7 +9,7 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/EcuaByte-lat/Cortex/actions/workflows/ci.yml"><img src="https://github.com/EcuaByte-lat/Cortex/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/EcuaByte-lat/Cortex/actions/workflows/unified.yml"><img src="https://github.com/EcuaByte-lat/Cortex/actions/workflows/unified.yml/badge.svg" alt="CI"></a>
   <a href="https://codecov.io/gh/EcuaByte-lat/Cortex"><img src="https://codecov.io/gh/EcuaByte-lat/Cortex/branch/main/graph/badge.svg" alt="Coverage"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
   <a href="https://marketplace.visualstudio.com/items?itemName=EcuaByte.cortex-vscode"><img src="https://img.shields.io/visual-studio-marketplace/v/EcuaByte.cortex-vscode?label=VS%20Code&logo=visualstudiocode&color=007ACC" alt="VS Code"></a>
@@ -80,8 +80,8 @@ Add to your Claude Desktop or VS Code settings:
 {
   "mcpServers": {
     "cortex": {
-      "command": "bun",
-      "args": ["run", "/path/to/Cortex/packages/mcp-server/dist/mcp-server.js"]
+      "command": "npx",
+      "args": ["-y", "@ecuabyte/cortex-mcp-server"]
     }
   }
 }

packages/mcp-server/README.md

@@ -0,0 +1,60 @@
+# Cortex MCP Server
+
+The **Model Context Protocol (MCP)** server for [Cortex](https://github.com/EcuaByte-lat/Cortex).
+
+Connects your AI tools (Claude Desktop, Cursor, Zed, etc.) to your project's persistent memory.
+
+## 🚀 Usage
+
+### Quick Start (npx)
+
+The easiest way to run the server is with `npx`:
+
+```bash
+npx -y @ecuabyte/cortex-mcp-server
+```
+
+### via Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "cortex": {
+      "command": "npx",
+      "args": ["-y", "@ecuabyte/cortex-mcp-server"]
+    }
+  }
+}
+```
+
+### via Cursor / Windsurf
+
+1. Go to **Settings** > **MCP**
+2. Add new server:
+   - **Type**: `command`
+   - **Command**: `npx`
+   - **Args**: `-y @ecuabyte/cortex-mcp-server`
+
+## 🛠️ Tools
+
+This server provides the following MCP tools to your AI agent:
+
+- `cortex_search`: Search project memories (facts, decisions, code patterns)
+- `cortex_add`: Add a new memory
+- `cortex_list`: List recent memories
+- `cortex_context`: Get intelligent context for a specific task
+- `cortex_scan`: Scan the current project to extract context automatically
+
+## 📦 Installation
+
+```bash
+npm install -g @ecuabyte/cortex-mcp-server
+# or
+bun add -g @ecuabyte/cortex-mcp-server
+```
+
+## 📄 License
+
+MIT

packages/mcp-server/package.json

@@ -12,7 +12,7 @@
     "dev": "bun run --watch src/mcp-server.ts",
     "start": "bun run dist/mcp-server.js",
     "typecheck": "bunx tsc --noEmit",
-    "generate-config": "bun run scripts/generate-config.ts"
+    "generate-config": "bun run src/mcp-server.ts generate-config"
   },
   "keywords": [
     "mcp",

packages/mcp-server/src/mcp-server.ts

@@ -14,6 +14,73 @@ const store = new MemoryStore();
 const router = new ContextRouter(store);
 const guard = new ContextGuard();
 
+// CLI Argument Handling for `generate-config`
+import { parseArgs } from 'node:util';
+
+try {
+  const args = process.argv.slice(2);
+  if (args[0] === 'generate-config') {
+    const { values } = parseArgs({
+      args: args,
+      options: {
+        target: {
+          type: 'string',
+        },
+      },
+      strict: false, // allow params we don't know yet (though we should know them)
+    });
+
+    const target = values.target as string | undefined;
+    const targets = ['claude', 'cursor', 'windsurf', 'goose'];
+
+    if (!target || !targets.includes(target)) {
+      console.error(`Usage: cortex-mcp generate-config --target <${targets.join('|')}>`);
+      process.exit(1);
+    }
+
+    const command = 'npx';
+    const cmdArgs = ['-y', '@ecuabyte/cortex-mcp-server'];
+    let config: Record<string, unknown> = {};
+
+    switch (target) {
+      case 'claude':
+        config = {
+          mcpServers: {
+            cortex: {
+              command,
+              args: cmdArgs,
+            },
+          },
+        };
+        break;
+      case 'cursor':
+      case 'windsurf':
+        config = {
+          cortex: {
+            type: 'command',
+            command,
+            args: cmdArgs,
+          },
+        };
+        break;
+      case 'goose':
+        console.log(`Run this command to configure Goose:`);
+        console.log(`goose configure mcp add cortex "${command} ${cmdArgs.join(' ')}"`);
+        process.exit(0);
+    }
+
+    console.log(JSON.stringify(config, null, 2));
+    process.exit(0);
+  }
+} catch (e) {
+  // If parsing fails or other issues, just ignore and proceed to server start
+  // or print error if it was clearly a CLI attempt
+  if (process.argv[2] === 'generate-config') {
+    console.error('Error generating config:', e);
+    process.exit(1);
+  }
+}
+
 // Initialize embedding provider if available (Ollama or OpenAI)
 let embeddingInitialized = false;
 (async () => {

packages/vscode-extension/package.json

@@ -56,7 +56,7 @@
   ],
   "devDependencies": {
     "@types/sql.js": "^1.4.9",
-    "@types/vscode": "^1.85.0",
+    "@types/vscode": "^1.107.0",
     "@vscode/vsce": "^3.7.1",
     "@ecuabyte/cortex-shared": "workspace:*"
   },

packages/vscode-extension/src/extension.ts

@@ -1,3 +1,4 @@
+import { setDefaultAutoSelectFamilyAttemptTimeout } from 'node:net';
 import type { Memory } from '@ecuabyte/cortex-shared';
 import * as vscode from 'vscode';
 import { ContextObserver } from './contextObserver';
@@ -9,6 +10,14 @@ import { CortexTaskProvider } from './taskProvider';
 import type { Tool } from './toolScanner';
 import { ToolTreeProvider } from './toolTreeProvider';
 
+// Set default timeout for IPv4/IPv6 family auto-selection to avoid long delays
+// This fixes: Set default auto-select family attempt timeout to 1000ms
+try {
+  setDefaultAutoSelectFamilyAttemptTimeout(1000);
+} catch (e) {
+  console.warn('[Cortex] Failed to set auto-select family timeout:', e);
+}
+
 export async function activate(context: vscode.ExtensionContext) {
   try {
     console.log('[Cortex] Extension activation started');

packages/vscode-extension/src/storage.ts

@@ -99,6 +99,19 @@ export class MemoryStore implements IMemoryStore {
         END
       `);
 
+      // Fix for "no such module: fts5" error
+      // If the DB was created by the CLI/Core (which uses Bun:sqlite with FTS5),
+      // the triggers will exist but sql.js (wasm) might not support FTS5.
+      // We safely drop them here to allow basic CRUD operations to work.
+      try {
+        const triggers = ['memories_ai', 'memories_ad', 'memories_bu', 'memories_au'];
+        for (const trigger of triggers) {
+          this.db.run(`DROP TRIGGER IF EXISTS ${trigger}`);
+        }
+      } catch (e) {
+        console.warn('[Cortex] Failed to clean up FTS5 triggers:', e);
+      }
+
       this.saveToFile();
     } catch (error) {
       console.error('[Cortex] Failed to initialize MemoryStore:', error);