genexus-mcp 2.3.0 → 2.3.1

package/README.md

@@ -2,8 +2,9 @@
 
 [![npm version](https://img.shields.io/npm/v/genexus-mcp.svg)](https://www.npmjs.com/package/genexus-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/genexus-mcp.svg)](https://www.npmjs.com/package/genexus-mcp)
-[![MCP Badge](https://lobehub.com/badge/mcp/lennix1337-genexus18mcp?style=for-the-badge)](https://lobehub.com/mcp/lennix1337-genexus18mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![SafeSkill 85/100](https://img.shields.io/badge/SafeSkill-85%2F100_Passes%20with%20Notes-yellow)](https://safeskill.dev/scan/lennix1337-genexus18mcp)
+[![MCP Badge](https://lobehub.com/badge/mcp/lennix1337-genexus18mcp)](https://lobehub.com/mcp/lennix1337-genexus18mcp)
 
 > **¿Hablás español?** → [Guía de inicio en español](docs/GETTING_STARTED.es.md)
 > **Stuck?** → [Troubleshooting guide](TROUBLESHOOTING.md)
@@ -70,6 +71,37 @@ Replace the placeholders or let the AI ask you for them.
 
 ---
 
+## Corporate install (fixed path, ASR-friendly)
+
+If your machine has **Microsoft Defender ASR**, **SmartScreen**, or another endpoint policy blocking unsigned binaries, the default `npx` flow is painful — `npx` caches the package under `%LOCALAPPDATA%\npm-cache\_npx\<hash>\...`, and the `<hash>` changes per version, so IT can't whitelist a stable path without a wildcard over the whole npm cache (which is too broad).
+
+Use the corporate installer instead. It extracts the binaries to a stable directory and registers the AI clients to launch the gateway directly from there — `npx` is never on the runtime path.
+
+```pwsh
+# One-liner — installs latest release, registers AI clients
+iex (irm https://raw.githubusercontent.com/lennix1337/Genexus18MCP/main/scripts/install.ps1)
+
+# With explicit KB and GeneXus paths
+$s = irm https://raw.githubusercontent.com/lennix1337/Genexus18MCP/main/scripts/install.ps1
+& ([scriptblock]::Create($s)) -Kb "C:\KBs\MyKB" -Gx "C:\Program Files (x86)\GeneXus\GeneXus18"
+```
+
+Install location:
+
+- **Admin shell** → `C:\Tools\GenexusMCP\`
+- **Non-admin shell** → `%LOCALAPPDATA%\Programs\GenexusMCP\`
+
+Paths to give to IT for the ASR / Defender exclusion list:
+
+```
+<InstallDir>\GxMcp.Gateway.exe
+<InstallDir>\worker\GxMcp.Worker.exe
+```
+
+Re-run the same one-liner later to **upgrade** — it detects the installed version (`version.txt` in the install dir) and downloads only if a newer release is available. Use `-Force` to reinstall the same version, `-Version v2.3.0` to pin a specific tag, `-NoClient` to skip AI client registration. Node.js 18+ must be installed for client registration; without it the script still extracts the binaries but you'll need to edit the client config (`claude_desktop_config.json` etc.) manually.
+
+---
+
 ## What can I ask the AI?
 
 Once installed, here's what unlocks. Try these as your first prompts:

package/cli/lib/config.js

@@ -148,6 +148,13 @@ function createConfigFile(kbPath, gxPath) {
 function patchClientConfig(targetConfigPath) {
     const clients = getClientConfigTargets();
 
+    // Set by scripts/install.ps1 for fixed-path corporate installs — clients
+    // launch the gateway exe directly instead of resolving via the npx cache.
+    const directExe = process.env.GENEXUS_MCP_GATEWAY_EXE;
+    const launcher = directExe
+        ? { command: directExe, args: [] }
+        : { command: process.platform === 'win32' ? 'npx.cmd' : 'npx', args: ['-y', 'genexus-mcp@latest'] };
+
     const patched = [];
     const failed = [];
 
@@ -163,11 +170,7 @@ function patchClientConfig(targetConfigPath) {
 
             const cfgObj = parsed || {};
             cfgObj.mcpServers = cfgObj.mcpServers || {};
-            cfgObj.mcpServers.genexus = {
-                command: process.platform === 'win32' ? 'npx.cmd' : 'npx',
-                args: ['-y', 'genexus-mcp@latest'],
-                env: { GX_CONFIG_PATH: targetConfigPath }
-            };
+            cfgObj.mcpServers.genexus = { ...launcher, env: { GX_CONFIG_PATH: targetConfigPath } };
 
             fs.writeFileSync(client.path, JSON.stringify(cfgObj, null, 2));
             patched.push(client.name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "mcpName": "io.github.lennix1337/genexus",
   "description": "GeneXus 18 MCP server — read, edit, and analyze GeneXus knowledge base objects (transactions, web panels, procedures, SDTs) directly from Claude, Cursor, and other AI agents over the Model Context Protocol.",
   "keywords": [

package/publish/GxMcp.Gateway.deps.json

@@ -6,7 +6,7 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v8.0": {
-      "GxMcp.Gateway/2.3.0": {
+      "GxMcp.Gateway/2.3.1": {
         "dependencies": {
           "Newtonsoft.Json": "13.0.3",
           "System.Management": "10.0.5",
@@ -81,7 +81,7 @@
     }
   },
   "libraries": {
-    "GxMcp.Gateway/2.3.0": {
+    "GxMcp.Gateway/2.3.1": {
       "type": "project",
       "serviceable": false,
       "sha512": ""