genexus-mcp 2.0.0 → 2.0.4

package/README.md

@@ -1,8 +1,13 @@
-# GeneXus 18 MCP Server (Genexus18MCP)
+# GeneXus MCP Server — GeneXus 18 for Claude, Cursor, and AI Agents
 
+[![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)
 
-A high-performance Model Context Protocol (MCP) server for GeneXus 18. It integrates native GeneXus SDK access via a .NET 8 gateway and a .NET Framework 4.8 worker, exposing direct read/write/analysis operations directly to AI Agents and IDEs.
+**GeneXus MCP Server** is a Model Context Protocol (MCP) server that exposes a GeneXus 18 knowledge base to AI agents — Claude Desktop, Claude Code, Cursor, and any MCP-compatible client. It lets the agent read, edit, analyze, and refactor GeneXus objects (transactions, web panels, procedures, SDTs, data providers) directly through the native GeneXus SDK, with a .NET 8 gateway over MCP/stdio and a .NET Framework 4.8 worker hosting the SDK.
+
+> **Search keywords:** GeneXus MCP · GeneXus 18 MCP · GeneXus AI · GeneXus Claude · Model Context Protocol GeneXus · GeneXus low-code AI agent
 
 ***
 

package/cli/commands/axi.js

@@ -988,7 +988,7 @@ async function handleLlmHelp(options, ctx) {
         },
         mcp: {
             parsePath: 'result.content[0].text',
-            expectedMeta: ['schemaVersion=mcp-axi/1', 'tool=<tool-name>'],
+            expectedMeta: ['_meta.schemaVersion=mcp-axi/2', '_meta.tool=<tool-name>'],
             listHelpers: ['returned', 'total', 'empty', 'hasMore', 'nextOffset'],
             shaping: ['fields=<csv|array>', 'axiCompact=true (query/list_objects)']
         },

package/docs/llm_cli_mcp_playbook.md

@@ -47,12 +47,17 @@ Recommended flags:
 
 For `tools/call`, parse `result.content[0].text` as JSON.
 
-Gateway AXI-like enrichments are additive:
-- `meta.schemaVersion = mcp-axi/1`
-- `meta.tool = <tool-name>`
+Gateway AXI-like enrichments are additive (under `_meta` — underscore-prefixed per MCP convention):
+- `_meta.schemaVersion = mcp-axi/2` (v2.0.0+)
+- `_meta.tool = <tool-name>`
 - Collection helpers when inferable: `returned`, `total`, `empty`, `hasMore`, `nextOffset`
-- Truncation signal: `meta.truncated=true` + contextual `help`
+- Truncation signal: `_meta.truncated=true` + contextual `help`
 - Idempotent writes may include `noChange=true`
+- v2.0.0 fields:
+  - `_meta.idempotent=true` on idempotency-cache hits.
+  - `_meta.batched=true` when the request used the `targets[]` plural form.
+  - `_meta.dryRun=true` on `dryRun` preview responses; full preview shape: `{plan:{touchedObjects, xmlDiff, brokenRefs, warnings}}`.
+  - `_meta.removedTools` advertised on `initialize` so agents can self-correct before a runtime `-32601`.
 
 Optional shaping for `genexus_query` and `genexus_list_objects`:
 - `fields`: array or CSV projection.
@@ -69,11 +74,22 @@ Disambiguation:
 
 Efficient reads:
 - `genexus_read(name='Obj', part='Source', offset=1, limit=200)`
-- For many files, prefer `genexus_batch_read`.
-
-Safe edits:
-- Use `genexus_edit(mode='patch', operation='Replace', context=..., content=..., expectedCount=1, dryRun=true)` before applying.
-- Use `genexus_batch_edit` for multi-object coordinated changes.
+- For many files, prefer `genexus_read(targets=['A','B','C'], part='Source')` (plural form).
+
+Safe edits (v2.0.0):
+- Preview before applying: any `genexus_edit` call accepts `dryRun: true` and returns `{plan: {touchedObjects, xmlDiff, brokenRefs, warnings}}` without mutation.
+- Three edit modes:
+  - `mode='xml'` (default) — full XML replacement.
+  - `mode='ops'` — typed semantic ops, e.g. `ops=[{op:'set_attribute', name:'Phone', type:'Character(20)'}]`. Catalog: `set_attribute`, `add_attribute`, `remove_attribute`, `add_rule`, `remove_rule`, `set_property`.
+  - `mode='patch'` — JSON-Patch RFC 6902 array, e.g. `patch=[{op:'replace', path:'/description', value:'new'}]`. Legacy string-form text patch (`mode='patch'` with string `patch`) still works for backward compatibility.
+- Multi-object coordinated changes: `genexus_edit(targets=[{name:'A', mode:'ops', ops:[...]}, {name:'B', mode:'xml', content:'...'}])`. Mutually exclusive with singular `name`.
+- Safe retries: pass `idempotencyKey: '<token>'` (charset `[A-Za-z0-9_-]`, 1–128 chars). Same key + same payload = cached result; same key + different payload = `idempotency_conflict` error. `dryRun` bypasses the cache.
+
+Removed in v2.0.0:
+- `genexus_batch_read` → use `genexus_read` with `targets[]`.
+- `genexus_batch_edit` → use `genexus_edit` with `targets[]`.
+- `genexus_edit` `changes` arg → use `targets[]`.
+- Calling a removed tool returns `-32601` with `error.data.replacedBy` and `error.data.argHint` for self-correction. `initialize` advertises `_meta.removedTools` upfront.
 
 ## Timeout and Long-Running Operations
 

package/package.json

@@ -1,7 +1,34 @@
 {
   "name": "genexus-mcp",
-  "version": "2.0.0",
-  "description": "A high-performance Model Context Protocol (MCP) server for GeneXus 18",
+  "version": "2.0.4",
+  "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": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "genexus",
+    "genexus-18",
+    "genexus18",
+    "claude",
+    "claude-desktop",
+    "claude-code",
+    "cursor",
+    "anthropic",
+    "ai",
+    "ai-agent",
+    "ai-agents",
+    "ai-tools",
+    "llm",
+    "llm-tools",
+    "low-code",
+    "code-generation",
+    "knowledge-base",
+    "developer-tools",
+    "axi",
+    "sdk",
+    "automation"
+  ],
   "scripts": {
     "test": "node --test cli/run.test.js",
     "prepack": "node scripts/clean-package.js"