@gavdi/cap-mcp 1.3.0 → 1.3.2

package/README.md

@@ -24,6 +24,8 @@ By integrating MCP with your CAP applications, you unlock:
 
 ## 🚀 Quick Setup
 
+> Want to read the full documentation? [Find it here](https://gavdilabs.github.io/cap-mcp-plugin/#/)
+
 ### Prerequisites
 
 - **Node.js**: Version 18 or higher

package/cds-plugin.js

@@ -5,7 +5,7 @@ const McpBuild = require("./lib/config/build");
 // Build tasks
 McpBuild.registerBuildTask();
 
-const plugin = new McpPlugin();
+const plugin = McpPlugin.getInstance();
 
 // Plugin hooks event registration
 cds.on("bootstrap", async (app) => {

package/lib/annotations/parser.js

@@ -133,11 +133,9 @@ function constructResourceAnnotation(serviceName, target, annotations, definitio
     const computedFields = new Set(Object.entries(model.definitions?.[entityTarget].elements ?? {})
         .filter(([_, v]) => new Map(Object.entries(v).map(([key, value]) => [key.toLowerCase(), value])).get("@core.computed"))
         .map(([k, _]) => k));
-    console.log("I AM TRYING TO PARSE", model.definitions);
     const omittedFields = new Set(Object.entries(model.definitions?.[entityTarget].elements ?? {})
         .filter(([_, v]) => v[constants_1.MCP_OMIT_PROP_KEY])
         .map(([k, _]) => k));
-    console.log("OMITTED FIELDS", omittedFields);
     const { properties, resourceKeys, propertyHints } = (0, utils_1.parseResourceElements)(definition, model);
     const restrictions = (0, utils_1.parseCdsRestrictions)(annotations.restrict, annotations.requires);
     return new structures_1.McpResourceAnnotation(annotations.name, annotations.description, target, serviceName, functionalities, properties, resourceKeys, foreignKeys, annotations.wrap, restrictions, computedFields, propertyHints, omittedFields);

package/lib/mcp/factory.js

@@ -24,8 +24,10 @@ function createMcpServer(config, annotations) {
     const server = new mcp_js_1.McpServer({
         name: config.name,
         version: config.version,
+    }, {
+        instructions: (0, instructions_1.getMcpInstructions)(config),
         capabilities: config.capabilities,
-    }, { instructions: (0, instructions_1.getMcpInstructions)(config) });
+    });
     if (!annotations) {
         logger_1.LOGGER.debug("No annotations provided, skipping registration...");
         return server;

package/lib/mcp.js

@@ -25,6 +25,8 @@ class McpPlugin {
     config;
     expressApp;
     annotations;
+    static _instance;
+    static isInitializing = false;
     /**
      * Creates a new MCP plugin instance with configuration and session management
      */
@@ -168,5 +170,38 @@ class McpPlugin {
             }
         });
     }
+    /**
+     * Get McpPlugin Instance
+     *
+     * @description  Double Lock singleton initialization.
+     * @returns McpPlugin
+     */
+    static getInstance() {
+        if (!McpPlugin._instance) {
+            if (!McpPlugin.isInitializing) {
+                McpPlugin.isInitializing = true;
+                if (!McpPlugin._instance) {
+                    McpPlugin._instance = new McpPlugin();
+                }
+                McpPlugin.isInitializing = false;
+            }
+            else {
+                /**
+                 * Busy Wait if it is initializing
+                 */
+                while (McpPlugin.isInitializing) { }
+                /**
+                 * check if not init, call again.
+                 */
+                if (!McpPlugin._instance) {
+                    return McpPlugin.getInstance();
+                }
+            }
+        }
+        return McpPlugin._instance;
+    }
+    static resetInstance() {
+        McpPlugin._instance = undefined;
+    }
 }
 exports.default = McpPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gavdi/cap-mcp",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "MCP Plugin for CAP",
   "keywords": [
     "MCP",
@@ -38,14 +38,16 @@
     "format": "prettier --check ./src",
     "format:fix": "prettier --write ./src \"**/*.json\"",
     "build:watch": "tsc --watch",
-    "release": "release-it"
+    "release": "release-it",
+    "docs:serve": "docsify serve docs",
+    "docs:links": "markdown-link-check docs/**/*.md"
   },
   "peerDependencies": {
-    "@sap/cds": "^9",
+    "@sap/cds": ">=9",
     "express": "^4"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.19.1",
+    "@modelcontextprotocol/sdk": "^1.23.0",
     "@sap/xssec": "^4.9.1",
     "cors": "^2.8.5",
     "helmet": "^8.1.0",
@@ -61,10 +63,12 @@
     "@types/node": "^24.0.3",
     "@types/sinon": "^17.0.4",
     "@types/supertest": "^6.0.2",
+    "docsify-cli": "^4.4.4",
     "eslint": "^9.29.0",
     "husky": "^9.1.7",
     "jest": "^29.7.0",
     "lint-staged": "^16.1.2",
+    "markdown-link-check": "^3.14.1",
     "prettier": "^3.5.3",
     "release-it": "^19.0.4",
     "sinon": "^21.0.0",