@sassoftware/sas-score-mcp-serverjs 0.4.0 → 0.4.1-3

package/cli.js

@@ -354,7 +354,6 @@ console.error('[Note] appEnvBase is', JSON.stringify(appEnvBase, null,2));
 // creat a dummy sessionId for stdio since there is only one session and transport in that case, and tools need a sessionId to access the appEnvBase and contexts
 let sessionId = randomUUID();
 sessionCache.set(sessionId, appEnvBase);
-useHapi = false; // for now disable hapi for authflow code since it is not working well, and code flow is not commonly used in server side applications, and http transport works better for code flow since it requires multiple back and forth calls to complete the auth process which is not ideal for stdio transport, this will be revisited in the future to either fix the issues with hapi or implement the code flow in a way that works better with stdio transport
 if (mcpType === 'stdio') {
   console.error('[Note] Setting up stdio transport with sessionId:', sessionId);
   console.error('[Note] Used in setting up tools and some persistence(not all).');
@@ -368,7 +367,7 @@ if (mcpType === 'stdio') {
     console.error('[Note] Using HAPI HTTP server...')
   } else {
     await expressMcpServer(mcpServer, sessionCache, appEnvBase);
-    console.error('[Note] MCP HTTP server started on port ' + appEnvBase.PORT);
+    console.error('[Note] MCP HTTP express server started on port ' + appEnvBase.PORT);
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sassoftware/sas-score-mcp-serverjs",
-  "version": "0.4.0",
+  "version": "0.4.1-3",
   "description": "A mcp server for SAS Viya",
   "author": "Deva Kumar <deva.kumar@sas.com>",
   "license": "Apache-2.0",
@@ -43,7 +43,7 @@
     "skills"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@sassoftware/restaf": "^5.6.0",
     "@sassoftware/restafedit": "^3.11.1-10",
     "@sassoftware/restaflib": "^5.6.0",
@@ -57,10 +57,8 @@
     "express-list-endpoints": "^7.1.1",
     "express-rate-limit": "^8.2.1",
     "helmet": "^8.1.0",
-    "mcp-framework": "^0.2.16",
     "node-cache": "^5.1.2",
     "open": "^11.0.0",
-    "puppeteer": "^24.34.0",
     "selfsigned": "^5.2.0",
     "undici": "^7.16.0",
     "uuid": "^13.0.0",

package/src/createMcpServer.js

@@ -73,11 +73,16 @@ async function createMcpServer(cache, _appContext) {
   let toolNames = [];
   toolSet.forEach((tool, i) => {
     let toolName = _appContext.brand + '-' + tool.name;
-    // console.error(`\n[Note] Registering tool ${i + 1} : ${toolName}`);
+    //tool.inputSchema.additionalProperties = false; // disallow extra properties 
+    let config = {
+      description: tool.description,
+      inputSchema: tool.inputSchema
+    }
+ 
+    console.error(`\n[Note] Registering tool ${i + 1} : ${toolName}`);
     let toolHandler = wrapf(cache, tool.handler);
-
-    mcpServer.tool(toolName, tool.description, tool.schema, toolHandler);
-    
+    console.log(`[Note] Registering tool ${toolName} with config: ${JSON.stringify(config)}`);
+    let r = mcpServer.registerTool(toolName, config, toolHandler);
     toolNames.push(toolName);
   });
   console.error(`[Note] Registered ${toolSet.length} tools: ${toolNames}`);

package/src/expressMcpServer.js

@@ -129,7 +129,7 @@ function requireBearer(req, res, next) {
   cache.set("headerCache", headerCache);
   next();
   console.error("Finished processing headers for /mcp request");
-  console.log("=======================================================");
+  console.error("=======================================================");
 }
 
 // process mcp endpoint requests

package/src/handleGetDelete.js

@@ -17,7 +17,7 @@ async function handleGetDelete(mcpServer, cache, req, h) {
      if (req.method === "GET") {
         // You can customize the response as needed
         console.error("[Note] Payload:", req.payload);
-        console.log("======================================================");
+        console.error("======================================================");
         await transport.handleRequest(req.raw.req, req.raw.res, req.payload);
         return h.abandon;
      }

package/src/toolHelpers/readCerts.js

@@ -9,23 +9,23 @@ function getCerts(tlsdir) {
         return null;
     }
 
-    console.log(`[Note] Reading certs from directory: ` + tlsdir);
+    console.error(`[Note] Reading certs from directory: ` + tlsdir);
     if (fs.existsSync(tlsdir) === false) {
         console.error("[Warning] Specified cert dir does not exist: " + tlsdir);
         return null;
     }
 
     let listOfFiles = fs.readdirSync(tlsdir);
-    console.log("[Note] TLS/SSL files found: " + listOfFiles);
+    console.error("[Note] TLS/SSL files found: " + listOfFiles);
     let options = {};
     for(let i=0; i < listOfFiles.length; i++) {
         let fname = listOfFiles[i];
         let name = tlsdir + '/' + listOfFiles[i];
         let key = fname.split('.')[0];
-        console.log('Reading TLS file: ' + name + ' as key: ' + key);
+        console.error('Reading TLS file: ' + name + ' as key: ' + key);
         options[key] = fs.readFileSync(name, { encoding: 'utf8' });
     }
-    console.log('cert files', Object.keys(options));
+    console.error('cert files', Object.keys(options));
     
     return options;
    

package/src/toolSet/devaScore.js

@@ -1,61 +1,62 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import {z} from 'zod';
-
-function devaScore(_appContext) {
-
-    let description = `
-deva-score — compute a numeric score based on two input values.
-
-USE when: calculate deva score, score these values, compute score for numbers
-DO NOT USE for: model scoring (use model-score), statistical calculations, data lookup
-
-PARAMETERS
-- a: number (required) — first input value
-- b: number (required) — second input value
-
-FORMULA: (a + b) * 42
-
-ROUTING RULES
-- "calculate deva score for 5 and 10" → { a: 5, b: 10 }
-- "score 1 and 2" → { a: 1, b: 2 }
-- "deva score a=3, b=7" → { a: 3, b: 7 }
-- Multiple numbers → chain calls left-to-right: call(first, second), then call(result, third)
-
-EXAMPLES
-- "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
-- "Score 1 and 2" → { a: 1, b: 2 } returns 126
-- "Deva score 20 and 30" → { a: 20, b: 30 } returns 2100
-
-NEGATIVE EXAMPLES (do not route here)
-- "Score this customer with credit model" (use model-score)
-- "Calculate the mean of these values" (use run-sas-program or sas-query)
-- "Statistical analysis of numbers" (use sas-query)
-
-RESPONSE
-Returns { score: (a + b) * 42 }
-    `;
-    let spec = {
-        name: 'deva-score',
-        aliases: ['devaScore','deva score','deva_score'],
-        description: description,
-        schema: {
-            a: z.number(),
-            b: z.number()
-        },
-        handler: async ({ a, b }) => {
-            console.error( a, b);
-            let r = {score: (a + b) * 42};
-            console.error('deva score result', r);
-            return {
-                content: [{type: 'text', text: 'deva score result: ' + JSON.stringify(r)}],
-                structuredContent: r
-             };
-            }
-        }
-        
-    return spec;
-}
-export default devaScore;
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+
+function devaScore(_appContext) {
+
+    let description = `
+deva-score — compute a numeric score based on two input values.
+
+USE when: calculate deva score, score these values, compute score for numbers
+DO NOT USE for: model scoring (use model-score), statistical calculations, data lookup
+
+PARAMETERS
+- a: number (required) — first input value
+- b: number (required) — second input value
+
+FORMULA: (a + b) * 42
+
+ROUTING RULES
+- "calculate deva score for 5 and 10" → { a: 5, b: 10 }
+- "score 1 and 2" → { a: 1, b: 2 }
+- "deva score a=3, b=7" → { a: 3, b: 7 }
+- Multiple numbers → chain calls left-to-right: call(first, second), then call(result, third)
+
+EXAMPLES
+- "Calculate deva score for 5 and 10" → { a: 5, b: 10 } returns 630
+- "Score 1 and 2" → { a: 1, b: 2 } returns 126
+- "Deva score 20 and 30" → { a: 20, b: 30 } returns 2100
+
+NEGATIVE EXAMPLES (do not route here)
+- "Score this customer with credit model" (use model-score)
+- "Calculate the mean of these values" (use run-sas-program or sas-query)
+- "Statistical analysis of numbers" (use sas-query)
+
+RESPONSE
+Returns { score: (a + b) * 42 }
+    `;
+    let spec = {
+        name: 'deva-score',
+        description: description,
+        inputSchema: z.object({
+            a: z.number(),
+            b: z.number(),
+        }),
+        required: ['a', 'b'],
+        handler: async ({ a, b }) => {
+            console.error(a, b);
+            let r = { score: (a + b) * 42 };
+            console.error('deva score result', r);
+            return {
+                content: [{ type: 'text', text: 'deva score result: ' + JSON.stringify(r) }],
+                structuredContent: r
+            };
+        }
+    }
+
+    return spec;
+}
+export default devaScore;
+

package/src/toolSet/findJob.js

@@ -5,16 +5,7 @@
 import { z } from 'zod';
 import _listJobs from '../toolHelpers/_listJobs.js';
 function findJob(_appContext) {
-  let llmDescription= {
-  "purpose": "Map natural language requests to find a job in SAS Viya and return structured results.",
-  "param_mapping": {
-    "name": "required - single name. If missing, ask 'Which job name would you like to find?'.",
-    "_userPrompt": "the original user prompt that triggered this tool."
-
-  },
-  "response_schema": "{ jobs: Array<string|object> }",
-  "behavior": "Return only JSON matching response_schema when invoked by an LLM. If no matches, return { jobs: [] }"
-};
+  
   let description = `
 find-job — locate a specific SAS Viya job.
 
@@ -49,18 +40,20 @@ Returns { jobs: [] } if not found; { jobs: [name, ...] } if found. Never halluci
 
   let spec = {
     name: 'find-job',
-    aliases: ['findJob','find job','find_job'],
     description: description,
-    schema: {
-      name: z.string(),
-      _userPrompt: z.string()
-    },
-    required: ['name'],
+    inputSchema: z.object({
+      name: z.string()
+    }),
     handler: async (params) => {
       let r = await _listJobs(params);
       return r;
     }
   }
+    
+
+  /* correct spec for registerTool with inputSchema */
+  
   return spec;
 }
 export default findJob;
+

package/src/toolSet/findJobdef.js

@@ -49,12 +49,10 @@ Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never h
 
   let spec = {
     name: 'find-jobdef',
-    aliases: ['findJobdef','find jobdef','find_jobdef'],
     description: description,
-    schema: {
-      name: z.string()
-    },
-    required: ['name'],
+    inputSchema: z.object({
+        name: z.string()
+    }),
     handler: async (params) => {
       let r = await _listJobdefs(params);
       return r;
@@ -63,3 +61,4 @@ Returns { jobdefs: [] } if not found; { jobdefs: [name, ...] } if found. Never h
   return spec;
 }
 export default findJobdef;
+

package/src/toolSet/findLibrary.js

@@ -1,68 +1,67 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listLibrary from '../toolHelpers/_listLibrary.js';
-function findLibrary(_appContext) {
-  
-  let description = `
-find-library — locate a specific CAS or SAS library.
-
-USE when: find library, find lib, does library exist, is library available, lookup library
-DO NOT USE for: list libraries (use list-libraries), find table/job/jobdef/model (use respective tools), table structure (use table-info), create library (use run-sas-program)
-
-PARAMETERS
-- name: string (required) — library/caslib name; if multiple supplied, use first
-- server: 'cas' | 'sas' (default: 'cas') — target environment
-
-ROUTING RULES
-- "find lib <name>" → { name: "<name>", server: "cas" }
-- "find lib <name> in cas" → { name: "<name>", server: "cas" }
-- "find library <name> in sas" → { name: "<name>", server: "sas" }
-- "does library <name> exist" → { name: "<name>", server: "cas" }
-- "find lib" with no name → ask "Which library name would you like to find?"
-- "list libraries / list libs" → use list-libraries instead
-- "tables in <lib>" → use list-tables instead
-
-EXAMPLES
-- "find lib Public" → { name: "Public", server: "cas" }
-- "find library sasuser in sas" → { name: "sasuser", server: "sas" }
-- "does library Formats exist" → { name: "Formats", server: "cas" }
-
-NEGATIVE EXAMPLES (do not route here)
-- "list libs" (use list-libraries)
-- "show tables in Public" (use list-tables)
-- "find table cars in sashelp" (use find-table)
-- "find job cars_job" (use find-job)
-
-ERRORS
-Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Never hallucinate library names.
-  `;
-
-  let spec = {
-    name: 'find-library',
-    aliases: ['findLibrary','find library','find_library'],
-    description: description,
-    schema: {
-      name: z.string(),
-      server: z.string().default('cas')
-    },
-    required: ['name'],
-    handler: async (params) => {
-      // normalize server to lowercase & default
-      if (!params.server) params.server = 'cas';
-      params.server = params.server.toLowerCase();
-
-      // If multiple names passed (comma or space separated), take the first token (defensive)
-      if (params.name && /[,\s]+/.test(params.name.trim())) {
-        params.name = params.name.split(/[,\s]+/).filter(Boolean)[0];
-      }
-
-      let r = await _listLibrary(params);
-      return r;
-    }
-  }
-  return spec;
-}
-export default findLibrary;
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listLibrary from '../toolHelpers/_listLibrary.js';
+function findLibrary(_appContext) {
+  
+  let description = `
+find-library — locate a specific CAS or SAS library.
+
+USE when: find library, find lib, does library exist, is library available, lookup library
+DO NOT USE for: list libraries (use list-libraries), find table/job/jobdef/model (use respective tools), table structure (use table-info), create library (use run-sas-program)
+
+PARAMETERS
+- name: string (required) — library/caslib name; if multiple supplied, use first
+- server: 'cas' | 'sas' (default: 'cas') — target environment
+
+ROUTING RULES
+- "find lib <name>" → { name: "<name>", server: "cas" }
+- "find lib <name> in cas" → { name: "<name>", server: "cas" }
+- "find library <name> in sas" → { name: "<name>", server: "sas" }
+- "does library <name> exist" → { name: "<name>", server: "cas" }
+- "find lib" with no name → ask "Which library name would you like to find?"
+- "list libraries / list libs" → use list-libraries instead
+- "tables in <lib>" → use list-tables instead
+
+EXAMPLES
+- "find lib Public" → { name: "Public", server: "cas" }
+- "find library sasuser in sas" → { name: "sasuser", server: "sas" }
+- "does library Formats exist" → { name: "Formats", server: "cas" }
+
+NEGATIVE EXAMPLES (do not route here)
+- "list libs" (use list-libraries)
+- "show tables in Public" (use list-tables)
+- "find table cars in sashelp" (use find-table)
+- "find job cars_job" (use find-job)
+
+ERRORS
+Returns { libraries: [] } if not found; { libraries: [name, ...] } if found. Never hallucinate library names.
+  `;
+
+  let spec = {
+    name: 'find-library',
+    description: description,
+    inputSchema: z.object({
+      name: z.string()
+    }),
+    
+    handler: async (params) => {
+      // normalize server to lowercase & default
+      if (!params.server) params.server = 'cas';
+      params.server = params.server.toLowerCase();
+
+      // If multiple names passed (comma or space separated), take the first token (defensive)
+      if (params.name && /[,\s]+/.test(params.name.trim())) {
+        params.name = params.name.split(/[,\s]+/).filter(Boolean)[0];
+      }
+
+      let r = await _listLibrary(params);
+      return r;
+    }
+  }
+  return spec;
+}
+export default findLibrary;
+

package/src/toolSet/findModel.js

@@ -44,12 +44,10 @@ Returns { models: [] } if not found; { models: [name, ...] } if found. Never hal
 
   let spec = {
     name: 'find-model',
-    aliases: ['findModel','find model','find_model'],
     description: description,
-    schema: {
-      'name': z.string()
-    },
-    required: ['name'],
+    inputSchema: z.object({
+      name: z.string()
+    }),
     handler: async (params) => { 
       let r = await _listModels(params);
       return r;
@@ -59,3 +57,4 @@ Returns { models: [] } if not found; { models: [name, ...] } if found. Never hal
 }
 
 export default findModel;
+

package/src/toolSet/findTable.js

@@ -45,14 +45,13 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
   
   let spec = {
     name: 'find-table',
-    aliases: ['findTable','find table','find_table'],
     description: description,
-    schema: {
-      server: z.string().default('cas'), // default server is 'cas',
+    inputSchema: z.object({
       name: z.string(),
-      lib: z.string()
-    },
-    required: ['name', 'lib'],
+      lib: z.string().optional(),
+      server: z.string().optional() // default server is 'cas'
+    }),
+    
     handler: async (params) => {
       // Check if the params.scenario is a string and parse it
       let r = await _listTables(params);
@@ -63,3 +62,4 @@ Returns { tables: [] } if not found; { tables: [name, ...] } if found. Never hal
 }
 
 export default findTable;
+

package/src/toolSet/getEnv.js

@@ -38,17 +38,20 @@ Returns variable name with current value, or null if not found. Return structure
     `;
   
     let spec = {
-        name: 'get-env',
-        aliases: ['get-env','get env','get environment'],
-        description: description,
-        schema: {
-            name: z.string()
+    name: 'get-env',
+    description: description,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string' }
+            },
+            required: ['name']
         },
-       
-        handler: async (params) => {
+    handler: async (params) => {
             return await _getEnv(params);
         }
     }
     return spec;
 }
 export default getEnv;
+

package/src/toolSet/listJobdefs.js

@@ -1,62 +1,61 @@
-/*
- * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
- * SPDX-License-Identifier: Apache-2.0
- */
-import { z } from 'zod';
-import _listJobdefs from '../toolHelpers/_listJobdefs.js';
-function listJobdefs(_appContext) {
-
-  let description = `
-list-jobdefs — enumerate SAS Viya job definitions (jobdefs) assets.
-
-USE when: list jobdefs, show jobdefs, browse jobdefs, list available jobdefs, next page
-DO NOT USE for: find single jobdef (use find-jobdef), execute jobdef (use run-jobdef), find job (use find-job), sas code (use run-sas-program)
-
-PARAMETERS
-- limit: number (default: 10) — number of jobdefs per page
-- start: number (default: 1) — 1-based page offset
-- where: string (default: '') — optional filter expression
-
-ROUTING RULES
-- list jobdefs → { start: 1, limit: 10 }
-- show me 25 jobdefs → { start: 1, limit: 25 }
-- next jobdefs → { start: previousStart + previousLimit, limit: previousLimit }
-
-EXAMPLES
-- list jobdefs → { start: 1, limit: 10 }
-- list 25 jobdefs → { start: 1, limit: 25 }
-- next jobdefs → { start: 11, limit: 10 }
-
-NEGATIVE EXAMPLES (do not route here)
-- find jobdef abc (use find-jobdef)
-- list jobs (use list-jobs)
-- run jobdef abc (use run-jobdef)
-- list models (use list-models)
-
-PAGINATION
-If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
-
-ERRORS
-Surface backend error directly; never fabricate jobdef names.
-  `;
-
-  let spec = {
-    name: 'list-jobdefs',
-    aliases: ['listJobdefs','list jobdefs','list_jobdefs'],
-    description: description,
-    schema: {
-      limit: z.number().default(10),
-      start: z.number().default(1),
-      where: z.string().default('')
-    },
-  // No 'server' required; backend context is implicit in helper
-  required: [],
-    handler: async (params) => {
-      // _listJobdefs handles all validation and defaults
-      const result = await _listJobdefs(params);
-      return result;
-    }
-  }
-  return spec;
-}
-export default listJobdefs;
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import _listJobdefs from '../toolHelpers/_listJobdefs.js';
+function listJobdefs(_appContext) {
+
+  let description = `
+list-jobdefs — enumerate SAS Viya job definitions (jobdefs) assets.
+
+USE when: list jobdefs, show jobdefs, browse jobdefs, list available jobdefs, next page
+DO NOT USE for: find single jobdef (use find-jobdef), execute jobdef (use run-jobdef), find job (use find-job), sas code (use run-sas-program)
+
+PARAMETERS
+- limit: number (default: 10) — number of jobdefs per page
+- start: number (default: 1) — 1-based page offset
+- where: string (default: '') — optional filter expression
+
+ROUTING RULES
+- list jobdefs → { start: 1, limit: 10 }
+- show me 25 jobdefs → { start: 1, limit: 25 }
+- next jobdefs → { start: previousStart + previousLimit, limit: previousLimit }
+
+EXAMPLES
+- list jobdefs → { start: 1, limit: 10 }
+- list 25 jobdefs → { start: 1, limit: 25 }
+- next jobdefs → { start: 11, limit: 10 }
+
+NEGATIVE EXAMPLES (do not route here)
+- find jobdef abc (use find-jobdef)
+- list jobs (use list-jobs)
+- run jobdef abc (use run-jobdef)
+- list models (use list-models)
+
+PAGINATION
+If returned length === limit, hint: next start = start + limit. Empty result with start > 1 means paged past end.
+
+ERRORS
+Surface backend error directly; never fabricate jobdef names.
+  `;
+
+  let spec = {
+    name: 'list-jobdefs',
+    description: description,
+    inputSchema: z.object({
+      limit: z.number().optional(),
+      start: z.number().optional(),
+      where: z.string().optional()
+    }),
+  // No 'server' required; backend context is implicit in helper
+    handler: async (params) => {
+      // _listJobdefs handles all validation and defaults
+      const result = await _listJobdefs(params);
+      return result;
+    }
+  }
+  return spec;
+}
+export default listJobdefs;
+