@sassoftware/sas-score-mcp-serverjs 0.0.2

package/test/listLibraries.test.js

@@ -0,0 +1,245 @@
+/*
+ * Copyright © 2025, SAS Institute Inc., Cary, NC, USA.  All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * Test for list-libraries tool using raw HTTP calls to MCP protocol
+ * This test connects to an MCP server running at http://localhost:8080/mcp
+ * and calls the list-libraries tool using direct HTTP requests.
+ */
+
+//import fetch from 'undici';
+
+const MCP_SERVER_URL = 'http://localhost:8080/mcp';
+
+/**
+ * Make an MCP request using HTTP POST
+ */
+async function mcpRequest(method, params = {}) {
+  const request = {
+    jsonrpc: '2.0',
+    id: Date.now(),
+    method: method,
+    params: params
+  };
+
+  const response = await fetch(MCP_SERVER_URL, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(request)
+  });
+
+  if (!response.ok) {
+    throw new Error(`HTTP error! status: ${response.status}`);
+  }
+
+  const data = await response.json();
+  
+  if (data.error) {
+    throw new Error(`MCP error: ${data.error.message}`);
+  }
+
+  return data.result;
+}
+
+async function testListLibraries() {
+  console.log('='.repeat(60));
+  console.log('Testing list-libraries tool via MCP Protocol (HTTP)');
+  console.log('Server: ' + MCP_SERVER_URL);
+  console.log('='.repeat(60));
+
+  let testsPassed = 0;
+  let testsFailed = 0;
+
+  try {
+    // Test 1: Initialize connection (get server info)
+    console.log('\n[1] Initializing connection...');
+    try {
+      const initResult = await mcpRequest('initialize', {
+        protocolVersion: '2024-11-05',
+        capabilities: {},
+        clientInfo: {
+          name: 'test-client',
+          version: '1.0.0'
+        }
+      });
+      console.log('✓ Connected successfully');
+      console.log(`  Server: ${initResult.serverInfo.name} v${initResult.serverInfo.version}`);
+      testsPassed++;
+    } catch (error) {
+      console.error('✗ Connection failed:', error.message);
+      testsFailed++;
+      throw error;
+    }
+
+    // Test 2: List available tools
+    console.log('\n[2] Listing available tools...');
+    try {
+      const toolsList = await mcpRequest('tools/list', {});
+      console.log(`✓ Found ${toolsList.tools.length} tools`);
+      
+      const listLibrariesTool = toolsList.tools.find(tool => 
+        tool.name.includes('sas-score-list-libraries')
+      );
+      
+      if (!listLibrariesTool) {
+        console.error('✗ list-libraries tool not found');
+        testsFailed++;
+        throw new Error('list-libraries tool not found');
+      } else {
+        console.log(`✓ Found tool: ${listLibrariesTool.name}`);
+        testsPassed++;
+      }
+
+      // Store tool name for subsequent tests
+      global.listLibrariesToolName = listLibrariesTool.name;
+    } catch (error) {
+      console.error('✗ Error listing tools:', error.message);
+      testsFailed++;
+      throw error;
+    }
+
+    // Test 3: List CAS libraries with defaults
+    console.log('\n[3] Test: List CAS libraries (default parameters)');
+    try {
+      const result = await mcpRequest('tools/call', {
+        name: global.listLibrariesToolName,
+        arguments: {}
+      });
+      
+      console.log('Response:', JSON.stringify(result, null, 2));
+      
+      if (result.isError) {
+        console.error('✗ Request returned error');
+        testsFailed++;
+      } else {
+        console.log('✓ Successfully listed CAS libraries');
+        testsPassed++;
+      }
+    } catch (error) {
+      console.error('✗ Error:', error.message);
+      testsFailed++;
+    }
+
+    // Test 4: List CAS libraries with custom limit
+    console.log('\n[4] Test: List CAS libraries with limit=5');
+    try {
+      const result = await mcpRequest('tools/call', {
+        name: global.listLibrariesToolName,
+        arguments: {
+          server: 'cas',
+          limit: 5
+        }
+      });
+      
+      console.log('Response:', JSON.stringify(result, null, 2));
+      
+      if (result.isError) {
+        console.error('✗ Request returned error');
+        testsFailed++;
+      } else {
+        console.log('✓ Successfully listed CAS libraries with limit');
+        testsPassed++;
+      }
+    } catch (error) {
+      console.error('✗ Error:', error.message);
+      testsFailed++;
+    }
+
+    // Test 5: List SAS libraries
+    console.log('\n[5] Test: List SAS libraries');
+    try {
+      const result = await mcpRequest('tools/call', {
+        name: global.listLibrariesToolName,
+        arguments: {
+          server: 'sas'
+        }
+      });
+      
+      console.log('Response:', JSON.stringify(result, null, 2));
+      
+      if (result.isError) {
+        console.error('✗ Request returned error');
+        testsFailed++;
+      } else {
+        console.log('✓ Successfully listed SAS libraries');
+        testsPassed++;
+      }
+    } catch (error) {
+      console.error('✗ Error:', error.message);
+      testsFailed++;
+    }
+
+    // Test 6: List libraries with pagination
+    console.log('\n[6] Test: List libraries with pagination (start=1, limit=3)');
+    try {
+      const result = await mcpRequest('tools/call', {
+        name: global.listLibrariesToolName,
+        arguments: {
+          server: 'cas',
+          start: 1,
+          limit: 3
+        }
+      });
+      
+      console.log('Response:', JSON.stringify(result, null, 2));
+      
+      if (result.isError) {
+        console.error('✗ Request returned error');
+        testsFailed++;
+      } else {
+        console.log('✓ Successfully listed libraries with pagination');
+        testsPassed++;
+      }
+    } catch (error) {
+      console.error('✗ Error:', error.message);
+      testsFailed++;
+    }
+
+    // Test 7: Case normalization (uppercase server param)
+    console.log('\n[7] Test: Server parameter normalization (CAS → cas)');
+    try {
+      const result = await mcpRequest('tools/call', {
+        name: global.listLibrariesToolName,
+        arguments: {
+          server: 'CAS',
+          limit: 3
+        }
+      });
+      
+      console.log('Response:', JSON.stringify(result, null, 2));
+      
+      if (result.isError) {
+        console.error('✗ Request returned error');
+        testsFailed++;
+      } else {
+        console.log('✓ Successfully normalized server parameter');
+        testsPassed++;
+      }
+    } catch (error) {
+      console.error('✗ Error:', error.message);
+      testsFailed++;
+    }
+
+  } catch (error) {
+    console.error('\n✗ Fatal error:', error);
+    testsFailed++;
+  } finally {
+    // Summary
+    console.log('\n' + '='.repeat(60));
+    console.log('TEST SUMMARY');
+    console.log('='.repeat(60));
+    console.log(`Tests Passed: ${testsPassed}`);
+    console.log(`Tests Failed: ${testsFailed}`);
+    console.log(`Total Tests:  ${testsPassed + testsFailed}`);
+    console.log('='.repeat(60));
+
+    process.exit(testsFailed > 0 ? 1 : 0);
+  }
+}
+
+// Run the test
+testListLibraries();

package/tool-developer-guide.md

@@ -0,0 +1,80 @@
+# Instructions for modifying or adding new tools
+
+
+
+## src/toolset
+
+This folder contains all the tools defined. The tools must conform to the MCP standards.
+The mcp server will add the branding prefix to the tools. By default it is `sas-score-`.
+
+> If you wish to change the branding, edit cli.js and replace the constant BRAND with your own brand.
+Do not specify the branding in the tool definition
+
+> See TOOL_DESCRIPTION_TEMPLATE for recommendations on how to write the description for a tool. And obviously this 
+document was created with the help of LLM.
+
+### Parameters to a tool helper
+
+The params to a tool handler is determined by the LLM based on the description of the tool.
+
+In this library that params object is extended with the *_appContext* object. 
+
+A typical handler in the tool spec will now look like this:
+
+```js
+{...
+    handler: async (params) => {
+        let {a,b, _appContext} = params;
+        ...rest of the code...
+    }
+}
+```
+See the files in src/toolHelpers folder for more examples
+
+
+### src/toolHelpers
+
+All code related to handling the prompt request are defined in this folder. This is just a convention of the author and not a hard and fast rule.
+
+
+
+The _appContext object is shown below
+
+```js
+{
+    storeConfig: {},/* for restaf users */
+    viyaCert: {} /* object with ssl/tsl certificates to connect to viya */
+    logonPayload: {}/* viya logon payload  to connect to viya */
+    sas: string,  /* 'SAS compute context' - default: SAS Job Execution compute context */
+    cas: string /* name of the cas server (default: cas-shared-default*/,
+    ext: {} /* place for tool developers to store information */
+}
+```
+
+The logonPayload object has the following information based on the AUTHFLOW value
+
+#### AUTHTYPE=sascli|token
+```js
+{
+    host: string, /* current Viya Server URL*/
+    authType: string /* for restaf users */
+    token: string, /* current token */
+    tokenType: 'Bearer'
+    
+}
+```
+
+#### AUTHTYPE=pasword
+
+```js
+{
+    host: viya-host-url
+    authType: "password",
+    user: string,
+    password: string,
+    clientID: clientid,
+    clientSecret: clientsecret
+}
+
+```
+

package/types.js

@@ -0,0 +1,25 @@
+/** 
+ * logonPayload
+ * @typedef {Object} logonPayload
+ * @property {string} host - the SAS VIya URL 
+ * @property {string} auth_type - The authentication type (for restaf users).
+ * @property {string} token - The authentication token.
+ * @property {string} tokenType - The type of the token (e.g., Bearer). 
+ */
+
+/**
+ * _appContext
+ * @typedef {Object} _appContext
+ * @property {Object} store - restaf store instance.(for restaf users)
+ * @property {Object} storeConfig - Configuration for the restaf store.
+ * @property {Object} casSession - restaf cas session instance.(for restaf users)
+ * @property {Object} computeSession - restaf compute session instance.(for restaf users)
+ * @property {Object} viyaCert - SSL/TSL certificate information.
+ * @property {logonPayload} logonPayload - kogonPayload object 
+ * @property {string|null} casServerId - cas server id. Default is null.(future)
+ * @property {string|null} computeServerId - compute server id. Default is null(future).
+ * @property {string|null} sas - SAS compute contextModel
+ * @property {Object|null} cas - cas server name
+ * @property {Object} ext - Additional extensions that a developer may want to add.
+ */
+