genexus-mcp 1.1.1 → 1.1.3

package/README.md

@@ -10,31 +10,27 @@ A high-performance Model Context Protocol (MCP) server for GeneXus 18. It integr
 
 You **do not** need to clone this repository or install anything globally if you have Node.js installed. You can configure your AI Assistant (Claude Desktop, Cursor, RooCode, etc.) to fetch and run the server dynamically!
 
-### 1. Create your Local Config
-Create a `config.json` inside your working directory telling the AI where your GeneXus is installed and which Knowledge Base you want to interact with:
+### 1. Zero Configuration (For Cursor, Cline & Roo)
+If your AI Tool runs inside an IDE (where the Current Working Directory is your KB), you don't need to configure anything. `genexus-mcp` automatically discovers where GeneXus is installed and dynamically binds to your current Knowledge Base!
 
-```json
-{
-  "GeneXus": { 
-    "InstallationPath": "C:\\Program Files (x86)\\GeneXus\\GeneXus18" 
-  },
-  "Environment": { 
-    "KBPath": "C:\\KBs\\YourKB" 
-  }
-}
+### 2. Guided Setup Wizard (For Claude Desktop & Antigravity)
+If you are using a Global Desktop Agent, its "Current Directory" is the global `Program Files` directory, not your project. Therefore, you must generate a `config.json` file.
+Open a terminal in any folder and run our **Setup Wizard**:
+
+```bash
+npx genexus-mcp init
 ```
+*The wizard will ask you for your KB folder and GeneXus path, create the configuration, and output the exact JSON snippet you must paste into your AI Assistant!*
 
-### 2. Configure your AI Assistant
-Add the `mcpServers` configuration block into your AI tool (e.g. `claude_desktop_config.json`):
+### 3. Add to your AI Assistant
+Add the `mcpServers` configuration block into your AI Tool settings.
 
 ```json
 "mcpServers": {
   "genexus": {
-    "command": "npx",
-    "args": ["-y", "genexus-mcp"],
-    "env": {
-      "GX_CONFIG_PATH": "C:\\path\\to\\your\\config.json"
-    }
+    "command": "npx.cmd", // Windows requires npx.cmd
+    "args": ["-y", "genexus-mcp@latest"]
+    // "env": { "GX_CONFIG_PATH": "C:\\path\\to\\your\\config.json" } // Only if generated by 'init'!
   }
 }
 ```

package/cli/run.js

@@ -4,15 +4,109 @@ const path = require('path');
 const fs = require('fs');
 
 const cwdConfigPath = path.join(process.cwd(), 'config.json');
+const args = process.argv.slice(2);
+
+// Interactive Setup Wizard
+if (args[0] === 'init' || args[0] === 'setup') {
+    console.log('================================================');
+    console.log('🚀 GeneXus MCP - Zero Configuration Setup Wizard');
+    console.log('================================================\n');
+
+    const readline = require('readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+    let defaultGx = "C:\\Program Files (x86)\\GeneXus\\GeneXus18";
+    const possibleGxPaths = [
+        "C:\\Program Files (x86)\\GeneXus\\GeneXus18",
+        "C:\\Program Files (x86)\\GeneXus\\GeneXus17",
+        "C:\\Program Files\\GeneXus\\GeneXus18"
+    ];
+    for (const p of possibleGxPaths) {
+        if (fs.existsSync(path.join(p, 'genexus.exe'))) { defaultGx = p; break; }
+    }
+
+    rl.question('1. Enter your Knowledge Base folder path\n   (Default: ' + process.cwd() + '):\n   > ', (kbAnswer) => {
+        const finalKb = kbAnswer.trim() || process.cwd();
+        
+        rl.question('\n2. Enter your GeneXus Installation path\n   (Default: ' + defaultGx + '):\n   > ', (gxAnswer) => {
+            const finalGx = gxAnswer.trim() || defaultGx;
+            
+            const targetConfigPath = path.join(finalKb, 'config.json');
+            const defaultConfig = {
+                GeneXus: { InstallationPath: finalGx },
+                Environment: { KBPath: finalKb }
+            };
+            
+            try {
+                if (!fs.existsSync(finalKb)) fs.mkdirSync(finalKb, { recursive: true });
+                fs.writeFileSync(targetConfigPath, JSON.stringify(defaultConfig, null, 2));
+                console.log('\n✅ Success! Configuration saved at: ' + targetConfigPath + '\n');
+                console.log('If you are using a Global Agent (like Claude Desktop or Antigravity),');
+                console.log('you MUST copy this exact path and put it in your AI configuration:\n');
+                console.log(`    "env": {`);
+                console.log(`       "GX_CONFIG_PATH": "${targetConfigPath.replace(/\\/g, '\\\\')}"`);
+                console.log(`    }\n`);
+            } catch (err) {
+                console.error('\n❌ Failed to save configuration: ' + err.message);
+            }
+            rl.close();
+            process.exit(0);
+        });
+    });
+    return; // Stop execution
+}
 
 // Check if config.json exists in CWD. If so, bind it to GX_CONFIG_PATH.
 if (fs.existsSync(cwdConfigPath)) {
     process.env.GX_CONFIG_PATH = cwdConfigPath;
 } else if (!process.env.GX_CONFIG_PATH) {
-    console.error('[genexus-mcp] ERROR: No config.json found in the current directory!');
-    console.error('[genexus-mcp] Please create a config.json file here with at least the KBPath and GeneXus InstallationPath.');
-    console.error('[genexus-mcp] Or specify the path via the GX_CONFIG_PATH environment variable.');
-    process.exit(1);
+    const possibleGxPaths = [
+        "C:\\Program Files (x86)\\GeneXus\\GeneXus18",
+        "C:\\Program Files (x86)\\GeneXus\\GeneXus17",
+        "C:\\Program Files (x86)\\GeneXus\\GeneXus16",
+        "C:\\Program Files\\GeneXus\\GeneXus18",
+        "C:\\Program Files\\GeneXus\\GeneXus17"
+    ];
+
+    let foundGxPath = null;
+    for (const p of possibleGxPaths) {
+        if (fs.existsSync(path.join(p, 'genexus.exe'))) {
+            foundGxPath = p;
+            break;
+        }
+    }
+
+    if (foundGxPath) {
+        // Smart Safety: Only auto-generate config if CWD actually looks like a GeneXus KB!
+        // Desktop Agents like Claude or Antigravity often execute in their Program Files.
+        const filesInCwd = fs.readdirSync(process.cwd());
+        const isActuallyAKB = filesInCwd.some(f => f.toLowerCase().endsWith('.gxw') || f.toLowerCase() === 'knowledgebase.connection');
+
+        if (isActuallyAKB) {
+            console.error(`[genexus-mcp] Auto-discovered GeneXus at: ${foundGxPath}`);
+            console.error(`[genexus-mcp] Generating default config.json for KB at: ${process.cwd()}`);
+            
+            const defaultConfig = {
+                GeneXus: { InstallationPath: foundGxPath },
+                Environment: { KBPath: process.cwd() }
+            };
+            
+            fs.writeFileSync(cwdConfigPath, JSON.stringify(defaultConfig, null, 2));
+            process.env.GX_CONFIG_PATH = cwdConfigPath;
+        } else {
+            console.error('[genexus-mcp] ERROR: Zero-Config failed. The current executing directory is NOT a GeneXus Knowledge Base.');
+            console.error(`[genexus-mcp] CWD: ${process.cwd()}`);
+            console.error('\n[!!] Fix this issue by running the interactive setup wizard:');
+            console.error('     npx genexus-mcp init\n');
+            process.exit(1);
+        }
+    } else {
+        console.error('[genexus-mcp] ERROR: No config.json found in the current directory!');
+        console.error('[genexus-mcp] Auto-discovery for GeneXus installation failed.');
+        console.error('\n[!!] Fix this issue by running the interactive setup wizard:');
+        console.error('     npx genexus-mcp init\n');
+        process.exit(1);
+    }
 }
 
 // Locate the bundled .NET executable inside the publish folder

package/package.json

@@ -1,25 +1,25 @@
-{
-  "name": "genexus-mcp",
-  "version": "1.1.1",
-  "description": "A high-performance Model Context Protocol (MCP) server for GeneXus 18",
-  "bin": {
-    "genexus-mcp": "cli/run.js"
-  },
-  "files": [
-    "cli",
-    "publish"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "author": "lennix1337",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lennix1337/Genexus18MCP.git"
-  },
-  "bugs": {
-    "url": "https://github.com/lennix1337/Genexus18MCP/issues"
-  },
-  "homepage": "https://github.com/lennix1337/Genexus18MCP#readme"
-}
+{
+  "name": "genexus-mcp",
+  "version": "1.1.3",
+  "description": "A high-performance Model Context Protocol (MCP) server for GeneXus 18",
+  "bin": {
+    "genexus-mcp": "cli/run.js"
+  },
+  "files": [
+    "cli",
+    "publish"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "author": "lennix1337",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lennix1337/Genexus18MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/lennix1337/Genexus18MCP/issues"
+  },
+  "homepage": "https://github.com/lennix1337/Genexus18MCP#readme"
+}

package/publish/gateway_debug.log

@@ -5936,3 +5936,12 @@
 [2026-04-01 15:07:49.469] [HTTP] Received tools/list (ID: 1) - Body: {"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"progressToken":0}}}
 [2026-04-01 15:07:49.470] [HTTP] Serializing response for 1...
 [2026-04-01 15:07:49.470] [HTTP] Sending 14100 bytes to 1
+[2026-04-09 15:48:11.283] === Gateway starting (Stdio Mode) ===
+[2026-04-09 15:48:11.300] [Gateway] Loading config from: C:\Users\2635801\.gemini\antigravity\brain\7365ac0f-28d5-4326-a546-3e37e2ba58e9\scratch_test\config.json
+[2026-04-09 15:48:11.362] [Gateway] KB Path configured: C:\Users\2635801\.gemini\antigravity\brain\7365ac0f-28d5-4326-a546-3e37e2ba58e9\scratch_test
+[2026-04-09 15:48:11.365] [Gateway] Startup orphan-kill disabled. Existing gateway reuse is handled by the extension client.
+[2026-04-09 15:48:11.387] === Gateway starting (Stdio Mode) ===
+[2026-04-09 15:48:11.388] [Gateway] Initializing Worker lifecycle...
+[2026-04-09 15:48:11.391] [Gateway] Worker lifecycle ready.
+[2026-04-09 15:48:11.391] [Gateway] Setting up .gx_mirror watcher...
+[2026-04-09 15:48:11.392] [Gateway] .gx_mirror watcher active.