genexus-mcp 1.1.2 → 1.1.4

package/README.md

@@ -10,19 +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. Go to your Knowledge Base folder
-You don't need to configure anything. By default, the `genexus-mcp` automatically discovers where GeneXus 18/17 is installed on your `C:\` drive and dynamically maps the Knowledge Base to your Current Working Directory!
+### 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!
 
-*(If you are running the AI tool outside your KB directory, you can manually create a `config.json` with `Environment.KBPath` and `GeneXus.InstallationPath` to override the auto-discovery).*
+### 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**:
 
-### 2. Configure your AI Assistant
-Add the `mcpServers` configuration block into your AI tool (e.g. `claude_desktop_config.json`):
+```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!*
+
+### 3. Add to your AI Assistant
+Add the `mcpServers` configuration block into your AI Tool settings.
 
 ```json
 "mcpServers": {
   "genexus": {
-    "command": "npx",
+    "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,6 +4,97 @@ 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));
+                
+                const os = require('os');
+                console.log('\n✅ Success! Configuration saved at: ' + targetConfigPath + '\n');
+                
+                // AI Client Auto-Patching
+                const claudeWin = path.join(os.homedir(), 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json');
+                const claudeMac = path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+                const antigravityCfg = path.join(os.homedir(), '.gemini', 'antigravity', 'mcp_config.json');
+
+                const patchConfig = (cfgPath, clientName) => {
+                    if (fs.existsSync(cfgPath)) {
+                        try {
+                            const rawStr = fs.readFileSync(cfgPath, 'utf8');
+                            const cfgStr = rawStr.replace(/^\uFEFF/, ''); // Strip BOM if present
+                            let cfgObj = {};
+                            if (cfgStr.trim() !== '') cfgObj = JSON.parse(cfgStr);
+                            
+                            cfgObj.mcpServers = cfgObj.mcpServers || {};
+                            cfgObj.mcpServers["genexus"] = {
+                                command: process.platform === 'win32' ? "npx.cmd" : "npx",
+                                args: ["-y", "genexus-mcp@latest"],
+                                env: { "GX_CONFIG_PATH": targetConfigPath }
+                            };
+                            
+                            fs.writeFileSync(cfgPath, JSON.stringify(cfgObj, null, 2));
+                            console.log(`🤖 Auto-configured ${clientName} successfully!`);
+                            return true;
+                        } catch (e) {
+                            console.log(`⚠️  Found ${clientName} but couldn't parse its config: ${e.message}`);
+                        }
+                    }
+                    return false;
+                };
+
+                const claudePatched = patchConfig(claudeWin, 'Claude Desktop') || patchConfig(claudeMac, 'Claude Desktop');
+                const antiPatched = patchConfig(antigravityCfg, 'Antigravity');
+
+                if (claudePatched || antiPatched) {
+                    console.log('\n🎉 You are all set! Please restart your AI Assistant to connect to GeneXus.');
+                } else {
+                    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)) {
@@ -26,20 +117,34 @@ if (fs.existsSync(cwdConfigPath)) {
     }
 
     if (foundGxPath) {
-        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;
+        // 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('[genexus-mcp] Please create a config.json file manually with at least the KBPath and GeneXus InstallationPath.');
+        console.error('\n[!!] Fix this issue by running the interactive setup wizard:');
+        console.error('     npx genexus-mcp init\n');
         process.exit(1);
     }
 }

package/package.json

@@ -1,25 +1,25 @@
-{
-  "name": "genexus-mcp",
-  "version": "1.1.2",
-  "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.4",
+  "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"
+}