@mcp-z/cli 1.0.0 → 1.0.3

package/dist/cjs/index.d.cts

@@ -1,6 +1,10 @@
+export { callToolCommand } from './commands/call-tool.js';
+export { getPromptCommand } from './commands/get-prompt.js';
+export { inspectCommand } from './commands/inspect.js';
 export { type Combination, type ConfigChoice, type ConfigurationMode, createConfigChoices, type Dimension, discoverServerJson, extractServerName, filterConfigChoices, generateConditionalCombinations, generateConfigFile, generateConfigObject, generateMatrixCombinations, shouldPromptEnvVar, TRANSPORT_MAP, } from './commands/manifest/generate.js';
 export { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.js';
 export { validateCommand } from './commands/manifest/validate.js';
+export { readResourceCommand } from './commands/read-resource.js';
 export { upCommand } from './commands/up.js';
 export { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.js';
 export { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.js';

package/dist/cjs/index.d.ts

@@ -1,6 +1,10 @@
+export { callToolCommand } from './commands/call-tool.js';
+export { getPromptCommand } from './commands/get-prompt.js';
+export { inspectCommand } from './commands/inspect.js';
 export { type Combination, type ConfigChoice, type ConfigurationMode, createConfigChoices, type Dimension, discoverServerJson, extractServerName, filterConfigChoices, generateConditionalCombinations, generateConfigFile, generateConfigObject, generateMatrixCombinations, shouldPromptEnvVar, TRANSPORT_MAP, } from './commands/manifest/generate.js';
 export { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.js';
 export { validateCommand } from './commands/manifest/validate.js';
+export { readResourceCommand } from './commands/read-resource.js';
 export { upCommand } from './commands/up.js';
 export { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.js';
 export { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.js';

package/dist/cjs/index.js

@@ -19,6 +19,9 @@ _export(exports, {
     get TRANSPORT_MAP () {
         return _generatets.TRANSPORT_MAP;
     },
+    get callToolCommand () {
+        return _calltoolts.callToolCommand;
+    },
     get createConfigChoices () {
         return _generatets.createConfigChoices;
     },
@@ -43,9 +46,18 @@ _export(exports, {
     get generateMatrixCombinations () {
         return _generatets.generateMatrixCombinations;
     },
+    get getPromptCommand () {
+        return _getpromptts.getPromptCommand;
+    },
     get getSchema () {
         return _jsonschemats.getSchema;
     },
+    get inspectCommand () {
+        return _inspectts.inspectCommand;
+    },
+    get readResourceCommand () {
+        return _readresourcets.readResourceCommand;
+    },
     get resolveServerConfig () {
         return _resolveserverconfigts.resolveServerConfig;
     },
@@ -62,9 +74,13 @@ _export(exports, {
         return _jsonschemats.validateSchema;
     }
 });
+var _calltoolts = require("./commands/call-tool.js");
+var _getpromptts = require("./commands/get-prompt.js");
+var _inspectts = require("./commands/inspect.js");
 var _generatets = require("./commands/manifest/generate.js");
 var _metadatareaderts = require("./commands/manifest/metadata-reader.js");
 var _validatets = require("./commands/manifest/validate.js");
+var _readresourcets = require("./commands/read-resource.js");
 var _upts = require("./commands/up.js");
 var _jsonschemats = require("./lib/json-schema.js");
 var _resolveserverconfigts = require("./lib/resolve-server-config.js");

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/index.ts"],"sourcesContent":["// Base types and type guards\n\nexport {\n  type Combination,\n  type ConfigChoice,\n  type ConfigurationMode,\n  createConfigChoices,\n  type Dimension,\n  discoverServerJson,\n  extractServerName,\n  filterConfigChoices,\n  generateConditionalCombinations,\n  generateConfigFile,\n  generateConfigObject,\n  generateMatrixCombinations,\n  shouldPromptEnvVar,\n  TRANSPORT_MAP,\n} from './commands/manifest/generate.ts';\nexport { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.ts';\n\n// Manifest commands\nexport { validateCommand } from './commands/manifest/validate.ts';\n// Commands\nexport { upCommand } from './commands/up.ts';\n// Library utilities\nexport { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.ts';\nexport { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.ts';\nexport * from './types.ts';\n"],"names":["MetadataReader","SCHEMA_URL","TRANSPORT_MAP","createConfigChoices","discoverServerJson","extractServerName","filterConfigChoices","generateConditionalCombinations","generateConfigFile","generateConfigObject","generateMatrixCombinations","getSchema","resolveServerConfig","shouldPromptEnvVar","upCommand","validateCommand","validateSchema"],"mappings":"AAAA,6BAA6B;;;;;;;;;;;;QAkBsBA;eAAAA,gCAAc;;QAO7CC;eAAAA,wBAAU;;QAT5BC;eAAAA,yBAAa;;QAVbC;eAAAA,+BAAmB;;QAEnBC;eAAAA,8BAAkB;;QAClBC;eAAAA,6BAAiB;;QACjBC;eAAAA,+BAAmB;;QACnBC;eAAAA,2CAA+B;;QAC/BC;eAAAA,8BAAkB;;QAClBC;eAAAA,gCAAoB;;QACpBC;eAAAA,sCAA0B;;QAWnBC;eAAAA,uBAAS;;QAC4CC;eAAAA,0CAAmB;;QAX/EC;eAAAA,8BAAkB;;QAQXC;eAAAA,eAAS;;QAFTC;eAAAA,2BAAe;;QAIQC;eAAAA,4BAAc;;;0BARvC;gCACuF;0BAG9D;oBAEN;4BAE4B;qCACmC;qBAC3E"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/index.ts"],"sourcesContent":["// Base types and type guards\n\nexport { callToolCommand } from './commands/call-tool.ts';\nexport { getPromptCommand } from './commands/get-prompt.ts';\nexport { inspectCommand } from './commands/inspect.ts';\nexport {\n  type Combination,\n  type ConfigChoice,\n  type ConfigurationMode,\n  createConfigChoices,\n  type Dimension,\n  discoverServerJson,\n  extractServerName,\n  filterConfigChoices,\n  generateConditionalCombinations,\n  generateConfigFile,\n  generateConfigObject,\n  generateMatrixCombinations,\n  shouldPromptEnvVar,\n  TRANSPORT_MAP,\n} from './commands/manifest/generate.ts';\nexport { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.ts';\n// Manifest commands\nexport { validateCommand } from './commands/manifest/validate.ts';\nexport { readResourceCommand } from './commands/read-resource.ts';\nexport { upCommand } from './commands/up.ts';\n\n// Library utilities\nexport { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.ts';\nexport { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.ts';\nexport * from './types.ts';\n"],"names":["MetadataReader","SCHEMA_URL","TRANSPORT_MAP","callToolCommand","createConfigChoices","discoverServerJson","extractServerName","filterConfigChoices","generateConditionalCombinations","generateConfigFile","generateConfigObject","generateMatrixCombinations","getPromptCommand","getSchema","inspectCommand","readResourceCommand","resolveServerConfig","shouldPromptEnvVar","upCommand","validateCommand","validateSchema"],"mappings":"AAAA,6BAA6B;;;;;;;;;;;;QAqBsBA;eAAAA,gCAAc;;QAO7CC;eAAAA,wBAAU;;QAT5BC;eAAAA,yBAAa;;QAjBNC;eAAAA,2BAAe;;QAOtBC;eAAAA,+BAAmB;;QAEnBC;eAAAA,8BAAkB;;QAClBC;eAAAA,6BAAiB;;QACjBC;eAAAA,+BAAmB;;QACnBC;eAAAA,2CAA+B;;QAC/BC;eAAAA,8BAAkB;;QAClBC;eAAAA,gCAAoB;;QACpBC;eAAAA,sCAA0B;;QAdnBC;eAAAA,6BAAgB;;QAyBhBC;eAAAA,uBAAS;;QAxBTC;eAAAA,yBAAc;;QAoBdC;eAAAA,mCAAmB;;QAKkCC;eAAAA,0CAAmB;;QAX/EC;eAAAA,8BAAkB;;QAOXC;eAAAA,eAAS;;QAFTC;eAAAA,2BAAe;;QAKQC;eAAAA,4BAAc;;;0BA1Bd;2BACC;yBACF;0BAgBxB;gCACuF;0BAE9D;8BACI;oBACV;4BAG4B;qCACmC;qBAC3E"}

package/dist/cjs/lib/json-schema.js

@@ -20,10 +20,11 @@ _export(exports, {
     }
 });
 var _ajv = require("ajv");
+var _ajvformats = /*#__PURE__*/ _interop_require_default(require("ajv-formats"));
 var _fs = /*#__PURE__*/ _interop_require_wildcard(require("fs"));
-var _module = require("module");
+var _modulerootsync = /*#__PURE__*/ _interop_require_default(require("module-root-sync"));
 var _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
-var _url = require("url");
+var _url = /*#__PURE__*/ _interop_require_wildcard(require("url"));
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
     try {
         var info = gen[key](arg);
@@ -53,6 +54,11 @@ function _async_to_generator(fn) {
         });
     };
 }
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
 function _getRequireWildcardCache(nodeInterop) {
     if (typeof WeakMap !== "function") return null;
     var cacheBabelInterop = new WeakMap();
@@ -193,17 +199,13 @@ function _ts_generator(thisArg, body) {
         };
     }
 }
-// ESM-compatible __dirname equivalent
-var __filename1 = (0, _url.fileURLToPath)(require("url").pathToFileURL(__filename).toString());
-var __dirname = _path.dirname(__filename1);
-// Import ajv-formats (CommonJS module - use createRequire for ESM compatibility)
-var require1 = (0, _module.createRequire)(require("url").pathToFileURL(__filename).toString());
-var addFormats = require1('ajv-formats');
+var __dirname = _path.dirname(typeof __filename !== 'undefined' ? __filename : _url.fileURLToPath(require("url").pathToFileURL(__filename).toString()));
+var packageRoot = (0, _modulerootsync.default)(__dirname);
 var SCHEMA_URL = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json';
 var schemaCache = null;
 function getSchema() {
     return _async_to_generator(function() {
-        var response, unused, bundledPath;
+        var response, unused, schemaPath;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -255,11 +257,11 @@ function getSchema() {
                     ];
                 case 6:
                     // Fallback to bundled schema
-                    bundledPath = _path.join(__dirname, '../../schemas/server.schema.json');
-                    if (!_fs.existsSync(bundledPath)) {
+                    schemaPath = _path.join(packageRoot, './schemas/server.schema.json');
+                    if (!_fs.existsSync(schemaPath)) {
                         throw new Error('Failed to fetch MCP schema from URL and no bundled schema found. ' + 'Check network connection or report this as a bug.');
                     }
-                    schemaCache = JSON.parse(_fs.readFileSync(bundledPath, 'utf8'));
+                    schemaCache = JSON.parse(_fs.readFileSync(schemaPath, 'utf8'));
                     return [
                         2,
                         schemaCache
@@ -286,7 +288,7 @@ function validateSchema(serverJson, serverName) {
                         strictSchema: false
                     });
                     // Add format validators (uri, email, etc.) to silence warnings
-                    addFormats(ajv);
+                    (0, _ajvformats.default)(ajv);
                     validate = ajv.compile(schema);
                     valid = validate(serverJson);
                     if (!valid) {

package/dist/cjs/lib/json-schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/lib/json-schema.ts"],"sourcesContent":["import { Ajv, type ErrorObject } from 'ajv';\nimport * as fs from 'fs';\nimport { createRequire } from 'module';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\n// ESM-compatible __dirname equivalent\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Import ajv-formats (CommonJS module - use createRequire for ESM compatibility)\nconst require = createRequire(import.meta.url);\nconst addFormats = require('ajv-formats');\n\nexport const SCHEMA_URL = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json';\n\nlet schemaCache: object | null = null;\n\n/**\n * Get MCP server.json schema (fetches once, then caches)\n *\n * Strategy:\n * 1. Return cached schema if available\n * 2. Try fetching latest schema from URL\n * 3. Fall back to bundled schema if network fails\n */\nexport async function getSchema(): Promise<object> {\n  // Return cached schema\n  if (schemaCache) {\n    return schemaCache;\n  }\n\n  try {\n    // Try fetching latest schema\n    const response = await fetch(SCHEMA_URL);\n    if (response.ok) {\n      schemaCache = (await response.json()) as object;\n      return schemaCache;\n    }\n  } catch {\n    // Network error - fall through to bundled version\n  }\n\n  // Fallback to bundled schema\n  const bundledPath = path.join(__dirname, '../../schemas/server.schema.json');\n  if (!fs.existsSync(bundledPath)) {\n    throw new Error('Failed to fetch MCP schema from URL and no bundled schema found. ' + 'Check network connection or report this as a bug.');\n  }\n\n  schemaCache = JSON.parse(fs.readFileSync(bundledPath, 'utf8')) as object;\n  return schemaCache;\n}\n\n/**\n * Validate server.json against MCP schema\n *\n * @param serverJson - Parsed server.json content to validate\n * @param serverName - Server name for error messages\n * @throws Error with detailed validation messages if invalid\n */\nexport async function validateSchema(serverJson: unknown, serverName: string): Promise<void> {\n  const schema = await getSchema();\n\n  const ajv = new Ajv({\n    allErrors: true,\n    verbose: true,\n    strictSchema: false, // Allow non-standard keywords like \"example\", \"choices\"\n  });\n\n  // Add format validators (uri, email, etc.) to silence warnings\n  addFormats(ajv);\n\n  const validate = ajv.compile(schema);\n  const valid = validate(serverJson);\n\n  if (!valid) {\n    const errors = validate.errors?.map((e: ErrorObject) => `  - ${e.instancePath || '(root)'} ${e.message}`).join('\\n') || 'Unknown validation error';\n\n    throw new Error(`Invalid server.json for '${serverName}':\\n${errors}\\n\\nThe server.json file does not conform to the MCP specification.\\nSee: https://modelcontextprotocol.io/specification/server\\n\\nTo fix: Update the server.json file to match the schema requirements above.`);\n  }\n}\n"],"names":["SCHEMA_URL","getSchema","validateSchema","__filename","fileURLToPath","__dirname","path","dirname","require","createRequire","addFormats","schemaCache","response","bundledPath","fetch","ok","json","join","fs","existsSync","Error","JSON","parse","readFileSync","serverJson","serverName","schema","ajv","validate","valid","errors","Ajv","allErrors","verbose","strictSchema","compile","map","e","instancePath","message"],"mappings":";;;;;;;;;;;QAcaA;eAAAA;;QAYSC;eAAAA;;QAkCAC;eAAAA;;;mBA5DgB;0DAClB;sBACU;4DACR;mBACQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAE9B,sCAAsC;AACtC,IAAMC,cAAaC,IAAAA,kBAAa,EAAC;AACjC,IAAMC,YAAYC,MAAKC,OAAO,CAACJ;AAE/B,iFAAiF;AACjF,IAAMK,WAAUC,IAAAA,qBAAa,EAAC;AAC9B,IAAMC,aAAaF,SAAQ;AAEpB,IAAMR,aAAa;AAE1B,IAAIW,cAA6B;AAU1B,SAAeV;;YAQZW,kBAUFC;;;;oBAjBN,uBAAuB;oBACvB,IAAIF,aAAa;wBACf;;4BAAOA;;oBACT;;;;;;;;;oBAImB;;wBAAMG,MAAMd;;;oBAAvBY,WAAW;yBACbA,SAASG,EAAE,EAAXH;;;;oBACa;;wBAAMA,SAASI,IAAI;;;oBAAlCL,cAAe;oBACf;;wBAAOA;;;;;;;;;;;;;;oBAMX,6BAA6B;oBACvBE,cAAcP,MAAKW,IAAI,CAACZ,WAAW;oBACzC,IAAI,CAACa,IAAGC,UAAU,CAACN,cAAc;wBAC/B,MAAM,IAAIO,MAAM,sEAAsE;oBACxF;oBAEAT,cAAcU,KAAKC,KAAK,CAACJ,IAAGK,YAAY,CAACV,aAAa;oBACtD;;wBAAOF;;;;IACT;;AASO,SAAeT,eAAesB,UAAmB,EAAEC,UAAkB;;YACpEC,QAEAC,KASAC,UACAC,OAGWD,kBAATE;;;;oBAfO;;wBAAM7B;;;oBAAfyB,SAAS;oBAETC,MAAM,IAAII,QAAG,CAAC;wBAClBC,WAAW;wBACXC,SAAS;wBACTC,cAAc;oBAChB;oBAEA,+DAA+D;oBAC/DxB,WAAWiB;oBAELC,WAAWD,IAAIQ,OAAO,CAACT;oBACvBG,QAAQD,SAASJ;oBAEvB,IAAI,CAACK,OAAO;;wBACJC,SAASF,EAAAA,mBAAAA,SAASE,MAAM,cAAfF,uCAAAA,iBAAiBQ,GAAG,CAAC,SAACC;mCAAmB,AAAC,OAAoCA,OAA9BA,EAAEC,YAAY,IAAI,UAAS,KAAa,OAAVD,EAAEE,OAAO;2BAAItB,IAAI,CAAC,UAAS;wBAExH,MAAM,IAAIG,MAAM,AAAC,4BAA4CU,OAAjBL,YAAW,QAAa,OAAPK,QAAO;oBACtE;;;;;;IACF"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/lib/json-schema.ts"],"sourcesContent":["import { Ajv, type ErrorObject } from 'ajv';\nimport addFormats from 'ajv-formats';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\n\nconst __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));\nconst packageRoot = moduleRoot(__dirname);\n\nexport const SCHEMA_URL = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json';\n\nlet schemaCache: object | null = null;\n\n/**\n * Get MCP server.json schema (fetches once, then caches)\n *\n * Strategy:\n * 1. Return cached schema if available\n * 2. Try fetching latest schema from URL\n * 3. Fall back to bundled schema if network fails\n */\nexport async function getSchema(): Promise<object> {\n  // Return cached schema\n  if (schemaCache) {\n    return schemaCache;\n  }\n\n  try {\n    // Try fetching latest schema\n    const response = await fetch(SCHEMA_URL);\n    if (response.ok) {\n      schemaCache = (await response.json()) as object;\n      return schemaCache;\n    }\n  } catch {\n    // Network error - fall through to bundled version\n  }\n\n  // Fallback to bundled schema\n  const schemaPath = path.join(packageRoot, './schemas/server.schema.json');\n  if (!fs.existsSync(schemaPath)) {\n    throw new Error('Failed to fetch MCP schema from URL and no bundled schema found. ' + 'Check network connection or report this as a bug.');\n  }\n\n  schemaCache = JSON.parse(fs.readFileSync(schemaPath, 'utf8')) as object;\n  return schemaCache;\n}\n\n/**\n * Validate server.json against MCP schema\n *\n * @param serverJson - Parsed server.json content to validate\n * @param serverName - Server name for error messages\n * @throws Error with detailed validation messages if invalid\n */\nexport async function validateSchema(serverJson: unknown, serverName: string): Promise<void> {\n  const schema = await getSchema();\n\n  const ajv = new Ajv({\n    allErrors: true,\n    verbose: true,\n    strictSchema: false, // Allow non-standard keywords like \"example\", \"choices\"\n  });\n\n  // Add format validators (uri, email, etc.) to silence warnings\n  addFormats(ajv);\n\n  const validate = ajv.compile(schema);\n  const valid = validate(serverJson);\n\n  if (!valid) {\n    const errors = validate.errors?.map((e: ErrorObject) => `  - ${e.instancePath || '(root)'} ${e.message}`).join('\\n') || 'Unknown validation error';\n\n    throw new Error(`Invalid server.json for '${serverName}':\\n${errors}\\n\\nThe server.json file does not conform to the MCP specification.\\nSee: https://modelcontextprotocol.io/specification/server\\n\\nTo fix: Update the server.json file to match the schema requirements above.`);\n  }\n}\n"],"names":["SCHEMA_URL","getSchema","validateSchema","__dirname","path","dirname","__filename","url","fileURLToPath","packageRoot","moduleRoot","schemaCache","response","schemaPath","fetch","ok","json","join","fs","existsSync","Error","JSON","parse","readFileSync","serverJson","serverName","schema","ajv","validate","valid","errors","Ajv","allErrors","verbose","strictSchema","addFormats","compile","map","e","instancePath","message"],"mappings":";;;;;;;;;;;QAUaA;eAAAA;;QAYSC;eAAAA;;QAkCAC;eAAAA;;;mBAxDgB;iEACf;0DACH;qEACG;4DACD;2DACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAErB,IAAMC,YAAYC,MAAKC,OAAO,CAAC,OAAOC,eAAe,cAAcA,aAAaC,KAAIC,aAAa,CAAC;AAClG,IAAMC,cAAcC,IAAAA,uBAAU,EAACP;AAExB,IAAMH,aAAa;AAE1B,IAAIW,cAA6B;AAU1B,SAAeV;;YAQZW,kBAUFC;;;;oBAjBN,uBAAuB;oBACvB,IAAIF,aAAa;wBACf;;4BAAOA;;oBACT;;;;;;;;;oBAImB;;wBAAMG,MAAMd;;;oBAAvBY,WAAW;yBACbA,SAASG,EAAE,EAAXH;;;;oBACa;;wBAAMA,SAASI,IAAI;;;oBAAlCL,cAAe;oBACf;;wBAAOA;;;;;;;;;;;;;;oBAMX,6BAA6B;oBACvBE,aAAaT,MAAKa,IAAI,CAACR,aAAa;oBAC1C,IAAI,CAACS,IAAGC,UAAU,CAACN,aAAa;wBAC9B,MAAM,IAAIO,MAAM,sEAAsE;oBACxF;oBAEAT,cAAcU,KAAKC,KAAK,CAACJ,IAAGK,YAAY,CAACV,YAAY;oBACrD;;wBAAOF;;;;IACT;;AASO,SAAeT,eAAesB,UAAmB,EAAEC,UAAkB;;YACpEC,QAEAC,KASAC,UACAC,OAGWD,kBAATE;;;;oBAfO;;wBAAM7B;;;oBAAfyB,SAAS;oBAETC,MAAM,IAAII,QAAG,CAAC;wBAClBC,WAAW;wBACXC,SAAS;wBACTC,cAAc;oBAChB;oBAEA,+DAA+D;oBAC/DC,IAAAA,mBAAU,EAACR;oBAELC,WAAWD,IAAIS,OAAO,CAACV;oBACvBG,QAAQD,SAASJ;oBAEvB,IAAI,CAACK,OAAO;;wBACJC,SAASF,EAAAA,mBAAAA,SAASE,MAAM,cAAfF,uCAAAA,iBAAiBS,GAAG,CAAC,SAACC;mCAAmB,AAAC,OAAoCA,OAA9BA,EAAEC,YAAY,IAAI,UAAS,KAAa,OAAVD,EAAEE,OAAO;2BAAIvB,IAAI,CAAC,UAAS;wBAExH,MAAM,IAAIG,MAAM,AAAC,4BAA4CU,OAAjBL,YAAW,QAAa,OAAPK,QAAO;oBACtE;;;;;;IACF"}

package/dist/esm/index.d.ts

@@ -1,6 +1,10 @@
+export { callToolCommand } from './commands/call-tool.js';
+export { getPromptCommand } from './commands/get-prompt.js';
+export { inspectCommand } from './commands/inspect.js';
 export { type Combination, type ConfigChoice, type ConfigurationMode, createConfigChoices, type Dimension, discoverServerJson, extractServerName, filterConfigChoices, generateConditionalCombinations, generateConfigFile, generateConfigObject, generateMatrixCombinations, shouldPromptEnvVar, TRANSPORT_MAP, } from './commands/manifest/generate.js';
 export { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.js';
 export { validateCommand } from './commands/manifest/validate.js';
+export { readResourceCommand } from './commands/read-resource.js';
 export { upCommand } from './commands/up.js';
 export { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.js';
 export { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.js';

package/dist/esm/index.js

@@ -1,9 +1,12 @@
 // Base types and type guards
+export { callToolCommand } from './commands/call-tool.js';
+export { getPromptCommand } from './commands/get-prompt.js';
+export { inspectCommand } from './commands/inspect.js';
 export { createConfigChoices, discoverServerJson, extractServerName, filterConfigChoices, generateConditionalCombinations, generateConfigFile, generateConfigObject, generateMatrixCombinations, shouldPromptEnvVar, TRANSPORT_MAP } from './commands/manifest/generate.js';
 export { MetadataReader } from './commands/manifest/metadata-reader.js';
 // Manifest commands
 export { validateCommand } from './commands/manifest/validate.js';
-// Commands
+export { readResourceCommand } from './commands/read-resource.js';
 export { upCommand } from './commands/up.js';
 // Library utilities
 export { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/index.ts"],"sourcesContent":["// Base types and type guards\n\nexport {\n  type Combination,\n  type ConfigChoice,\n  type ConfigurationMode,\n  createConfigChoices,\n  type Dimension,\n  discoverServerJson,\n  extractServerName,\n  filterConfigChoices,\n  generateConditionalCombinations,\n  generateConfigFile,\n  generateConfigObject,\n  generateMatrixCombinations,\n  shouldPromptEnvVar,\n  TRANSPORT_MAP,\n} from './commands/manifest/generate.ts';\nexport { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.ts';\n\n// Manifest commands\nexport { validateCommand } from './commands/manifest/validate.ts';\n// Commands\nexport { upCommand } from './commands/up.ts';\n// Library utilities\nexport { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.ts';\nexport { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.ts';\nexport * from './types.ts';\n"],"names":["createConfigChoices","discoverServerJson","extractServerName","filterConfigChoices","generateConditionalCombinations","generateConfigFile","generateConfigObject","generateMatrixCombinations","shouldPromptEnvVar","TRANSPORT_MAP","MetadataReader","validateCommand","upCommand","getSchema","SCHEMA_URL","validateSchema","resolveServerConfig"],"mappings":"AAAA,6BAA6B;AAE7B,SAIEA,mBAAmB,EAEnBC,kBAAkB,EAClBC,iBAAiB,EACjBC,mBAAmB,EACnBC,+BAA+B,EAC/BC,kBAAkB,EAClBC,oBAAoB,EACpBC,0BAA0B,EAC1BC,kBAAkB,EAClBC,aAAa,QACR,kCAAkC;AACzC,SAAmDC,cAAc,QAA6B,yCAAyC;AAEvI,oBAAoB;AACpB,SAASC,eAAe,QAAQ,kCAAkC;AAClE,WAAW;AACX,SAASC,SAAS,QAAQ,mBAAmB;AAC7C,oBAAoB;AACpB,SAASC,SAAS,EAAEC,UAAU,EAAEC,cAAc,QAAQ,uBAAuB;AAC7E,SAA8DC,mBAAmB,QAAQ,iCAAiC;AAC1H,cAAc,aAAa"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/index.ts"],"sourcesContent":["// Base types and type guards\n\nexport { callToolCommand } from './commands/call-tool.ts';\nexport { getPromptCommand } from './commands/get-prompt.ts';\nexport { inspectCommand } from './commands/inspect.ts';\nexport {\n  type Combination,\n  type ConfigChoice,\n  type ConfigurationMode,\n  createConfigChoices,\n  type Dimension,\n  discoverServerJson,\n  extractServerName,\n  filterConfigChoices,\n  generateConditionalCombinations,\n  generateConfigFile,\n  generateConfigObject,\n  generateMatrixCombinations,\n  shouldPromptEnvVar,\n  TRANSPORT_MAP,\n} from './commands/manifest/generate.ts';\nexport { type CliArgMetadata, type EnvVarMetadata, MetadataReader, type ServerMetadata } from './commands/manifest/metadata-reader.ts';\n// Manifest commands\nexport { validateCommand } from './commands/manifest/validate.ts';\nexport { readResourceCommand } from './commands/read-resource.ts';\nexport { upCommand } from './commands/up.ts';\n\n// Library utilities\nexport { getSchema, SCHEMA_URL, validateSchema } from './lib/json-schema.ts';\nexport { type InlineConfigOptions, type ResolvedServerConfig, resolveServerConfig } from './lib/resolve-server-config.ts';\nexport * from './types.ts';\n"],"names":["callToolCommand","getPromptCommand","inspectCommand","createConfigChoices","discoverServerJson","extractServerName","filterConfigChoices","generateConditionalCombinations","generateConfigFile","generateConfigObject","generateMatrixCombinations","shouldPromptEnvVar","TRANSPORT_MAP","MetadataReader","validateCommand","readResourceCommand","upCommand","getSchema","SCHEMA_URL","validateSchema","resolveServerConfig"],"mappings":"AAAA,6BAA6B;AAE7B,SAASA,eAAe,QAAQ,0BAA0B;AAC1D,SAASC,gBAAgB,QAAQ,2BAA2B;AAC5D,SAASC,cAAc,QAAQ,wBAAwB;AACvD,SAIEC,mBAAmB,EAEnBC,kBAAkB,EAClBC,iBAAiB,EACjBC,mBAAmB,EACnBC,+BAA+B,EAC/BC,kBAAkB,EAClBC,oBAAoB,EACpBC,0BAA0B,EAC1BC,kBAAkB,EAClBC,aAAa,QACR,kCAAkC;AACzC,SAAmDC,cAAc,QAA6B,yCAAyC;AACvI,oBAAoB;AACpB,SAASC,eAAe,QAAQ,kCAAkC;AAClE,SAASC,mBAAmB,QAAQ,8BAA8B;AAClE,SAASC,SAAS,QAAQ,mBAAmB;AAE7C,oBAAoB;AACpB,SAASC,SAAS,EAAEC,UAAU,EAAEC,cAAc,QAAQ,uBAAuB;AAC7E,SAA8DC,mBAAmB,QAAQ,iCAAiC;AAC1H,cAAc,aAAa"}

package/dist/esm/lib/json-schema.js

@@ -1,14 +1,11 @@
 import { Ajv } from 'ajv';
+import addFormats from 'ajv-formats';
 import * as fs from 'fs';
-import { createRequire } from 'module';
+import moduleRoot from 'module-root-sync';
 import * as path from 'path';
-import { fileURLToPath } from 'url';
-// ESM-compatible __dirname equivalent
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-// Import ajv-formats (CommonJS module - use createRequire for ESM compatibility)
-const require = createRequire(import.meta.url);
-const addFormats = require('ajv-formats');
+import * as url from 'url';
+const __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));
+const packageRoot = moduleRoot(__dirname);
 export const SCHEMA_URL = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json';
 let schemaCache = null;
 /**
@@ -34,11 +31,11 @@ let schemaCache = null;
     // Network error - fall through to bundled version
     }
     // Fallback to bundled schema
-    const bundledPath = path.join(__dirname, '../../schemas/server.schema.json');
-    if (!fs.existsSync(bundledPath)) {
+    const schemaPath = path.join(packageRoot, './schemas/server.schema.json');
+    if (!fs.existsSync(schemaPath)) {
         throw new Error('Failed to fetch MCP schema from URL and no bundled schema found. ' + 'Check network connection or report this as a bug.');
     }
-    schemaCache = JSON.parse(fs.readFileSync(bundledPath, 'utf8'));
+    schemaCache = JSON.parse(fs.readFileSync(schemaPath, 'utf8'));
     return schemaCache;
 }
 /**

package/dist/esm/lib/json-schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/lib/json-schema.ts"],"sourcesContent":["import { Ajv, type ErrorObject } from 'ajv';\nimport * as fs from 'fs';\nimport { createRequire } from 'module';\nimport * as path from 'path';\nimport { fileURLToPath } from 'url';\n\n// ESM-compatible __dirname equivalent\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// Import ajv-formats (CommonJS module - use createRequire for ESM compatibility)\nconst require = createRequire(import.meta.url);\nconst addFormats = require('ajv-formats');\n\nexport const SCHEMA_URL = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json';\n\nlet schemaCache: object | null = null;\n\n/**\n * Get MCP server.json schema (fetches once, then caches)\n *\n * Strategy:\n * 1. Return cached schema if available\n * 2. Try fetching latest schema from URL\n * 3. Fall back to bundled schema if network fails\n */\nexport async function getSchema(): Promise<object> {\n  // Return cached schema\n  if (schemaCache) {\n    return schemaCache;\n  }\n\n  try {\n    // Try fetching latest schema\n    const response = await fetch(SCHEMA_URL);\n    if (response.ok) {\n      schemaCache = (await response.json()) as object;\n      return schemaCache;\n    }\n  } catch {\n    // Network error - fall through to bundled version\n  }\n\n  // Fallback to bundled schema\n  const bundledPath = path.join(__dirname, '../../schemas/server.schema.json');\n  if (!fs.existsSync(bundledPath)) {\n    throw new Error('Failed to fetch MCP schema from URL and no bundled schema found. ' + 'Check network connection or report this as a bug.');\n  }\n\n  schemaCache = JSON.parse(fs.readFileSync(bundledPath, 'utf8')) as object;\n  return schemaCache;\n}\n\n/**\n * Validate server.json against MCP schema\n *\n * @param serverJson - Parsed server.json content to validate\n * @param serverName - Server name for error messages\n * @throws Error with detailed validation messages if invalid\n */\nexport async function validateSchema(serverJson: unknown, serverName: string): Promise<void> {\n  const schema = await getSchema();\n\n  const ajv = new Ajv({\n    allErrors: true,\n    verbose: true,\n    strictSchema: false, // Allow non-standard keywords like \"example\", \"choices\"\n  });\n\n  // Add format validators (uri, email, etc.) to silence warnings\n  addFormats(ajv);\n\n  const validate = ajv.compile(schema);\n  const valid = validate(serverJson);\n\n  if (!valid) {\n    const errors = validate.errors?.map((e: ErrorObject) => `  - ${e.instancePath || '(root)'} ${e.message}`).join('\\n') || 'Unknown validation error';\n\n    throw new Error(`Invalid server.json for '${serverName}':\\n${errors}\\n\\nThe server.json file does not conform to the MCP specification.\\nSee: https://modelcontextprotocol.io/specification/server\\n\\nTo fix: Update the server.json file to match the schema requirements above.`);\n  }\n}\n"],"names":["Ajv","fs","createRequire","path","fileURLToPath","__filename","url","__dirname","dirname","require","addFormats","SCHEMA_URL","schemaCache","getSchema","response","fetch","ok","json","bundledPath","join","existsSync","Error","JSON","parse","readFileSync","validateSchema","serverJson","serverName","schema","ajv","allErrors","verbose","strictSchema","validate","compile","valid","errors","map","e","instancePath","message"],"mappings":"AAAA,SAASA,GAAG,QAA0B,MAAM;AAC5C,YAAYC,QAAQ,KAAK;AACzB,SAASC,aAAa,QAAQ,SAAS;AACvC,YAAYC,UAAU,OAAO;AAC7B,SAASC,aAAa,QAAQ,MAAM;AAEpC,sCAAsC;AACtC,MAAMC,aAAaD,cAAc,YAAYE,GAAG;AAChD,MAAMC,YAAYJ,KAAKK,OAAO,CAACH;AAE/B,iFAAiF;AACjF,MAAMI,UAAUP,cAAc,YAAYI,GAAG;AAC7C,MAAMI,aAAaD,QAAQ;AAE3B,OAAO,MAAME,aAAa,+EAA+E;AAEzG,IAAIC,cAA6B;AAEjC;;;;;;;CAOC,GACD,OAAO,eAAeC;IACpB,uBAAuB;IACvB,IAAID,aAAa;QACf,OAAOA;IACT;IAEA,IAAI;QACF,6BAA6B;QAC7B,MAAME,WAAW,MAAMC,MAAMJ;QAC7B,IAAIG,SAASE,EAAE,EAAE;YACfJ,cAAe,MAAME,SAASG,IAAI;YAClC,OAAOL;QACT;IACF,EAAE,OAAM;IACN,kDAAkD;IACpD;IAEA,6BAA6B;IAC7B,MAAMM,cAAcf,KAAKgB,IAAI,CAACZ,WAAW;IACzC,IAAI,CAACN,GAAGmB,UAAU,CAACF,cAAc;QAC/B,MAAM,IAAIG,MAAM,sEAAsE;IACxF;IAEAT,cAAcU,KAAKC,KAAK,CAACtB,GAAGuB,YAAY,CAACN,aAAa;IACtD,OAAON;AACT;AAEA;;;;;;CAMC,GACD,OAAO,eAAea,eAAeC,UAAmB,EAAEC,UAAkB;IAC1E,MAAMC,SAAS,MAAMf;IAErB,MAAMgB,MAAM,IAAI7B,IAAI;QAClB8B,WAAW;QACXC,SAAS;QACTC,cAAc;IAChB;IAEA,+DAA+D;IAC/DtB,WAAWmB;IAEX,MAAMI,WAAWJ,IAAIK,OAAO,CAACN;IAC7B,MAAMO,QAAQF,SAASP;IAEvB,IAAI,CAACS,OAAO;YACKF;QAAf,MAAMG,SAASH,EAAAA,mBAAAA,SAASG,MAAM,cAAfH,uCAAAA,iBAAiBI,GAAG,CAAC,CAACC,IAAmB,CAAC,IAAI,EAAEA,EAAEC,YAAY,IAAI,SAAS,CAAC,EAAED,EAAEE,OAAO,EAAE,EAAErB,IAAI,CAAC,UAAS;QAExH,MAAM,IAAIE,MAAM,CAAC,yBAAyB,EAAEM,WAAW,IAAI,EAAES,OAAO,6MAA6M,CAAC;IACpR;AACF"}
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/lib/json-schema.ts"],"sourcesContent":["import { Ajv, type ErrorObject } from 'ajv';\nimport addFormats from 'ajv-formats';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\n\nconst __dirname = path.dirname(typeof __filename !== 'undefined' ? __filename : url.fileURLToPath(import.meta.url));\nconst packageRoot = moduleRoot(__dirname);\n\nexport const SCHEMA_URL = 'https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json';\n\nlet schemaCache: object | null = null;\n\n/**\n * Get MCP server.json schema (fetches once, then caches)\n *\n * Strategy:\n * 1. Return cached schema if available\n * 2. Try fetching latest schema from URL\n * 3. Fall back to bundled schema if network fails\n */\nexport async function getSchema(): Promise<object> {\n  // Return cached schema\n  if (schemaCache) {\n    return schemaCache;\n  }\n\n  try {\n    // Try fetching latest schema\n    const response = await fetch(SCHEMA_URL);\n    if (response.ok) {\n      schemaCache = (await response.json()) as object;\n      return schemaCache;\n    }\n  } catch {\n    // Network error - fall through to bundled version\n  }\n\n  // Fallback to bundled schema\n  const schemaPath = path.join(packageRoot, './schemas/server.schema.json');\n  if (!fs.existsSync(schemaPath)) {\n    throw new Error('Failed to fetch MCP schema from URL and no bundled schema found. ' + 'Check network connection or report this as a bug.');\n  }\n\n  schemaCache = JSON.parse(fs.readFileSync(schemaPath, 'utf8')) as object;\n  return schemaCache;\n}\n\n/**\n * Validate server.json against MCP schema\n *\n * @param serverJson - Parsed server.json content to validate\n * @param serverName - Server name for error messages\n * @throws Error with detailed validation messages if invalid\n */\nexport async function validateSchema(serverJson: unknown, serverName: string): Promise<void> {\n  const schema = await getSchema();\n\n  const ajv = new Ajv({\n    allErrors: true,\n    verbose: true,\n    strictSchema: false, // Allow non-standard keywords like \"example\", \"choices\"\n  });\n\n  // Add format validators (uri, email, etc.) to silence warnings\n  addFormats(ajv);\n\n  const validate = ajv.compile(schema);\n  const valid = validate(serverJson);\n\n  if (!valid) {\n    const errors = validate.errors?.map((e: ErrorObject) => `  - ${e.instancePath || '(root)'} ${e.message}`).join('\\n') || 'Unknown validation error';\n\n    throw new Error(`Invalid server.json for '${serverName}':\\n${errors}\\n\\nThe server.json file does not conform to the MCP specification.\\nSee: https://modelcontextprotocol.io/specification/server\\n\\nTo fix: Update the server.json file to match the schema requirements above.`);\n  }\n}\n"],"names":["Ajv","addFormats","fs","moduleRoot","path","url","__dirname","dirname","__filename","fileURLToPath","packageRoot","SCHEMA_URL","schemaCache","getSchema","response","fetch","ok","json","schemaPath","join","existsSync","Error","JSON","parse","readFileSync","validateSchema","serverJson","serverName","schema","ajv","allErrors","verbose","strictSchema","validate","compile","valid","errors","map","e","instancePath","message"],"mappings":"AAAA,SAASA,GAAG,QAA0B,MAAM;AAC5C,OAAOC,gBAAgB,cAAc;AACrC,YAAYC,QAAQ,KAAK;AACzB,OAAOC,gBAAgB,mBAAmB;AAC1C,YAAYC,UAAU,OAAO;AAC7B,YAAYC,SAAS,MAAM;AAE3B,MAAMC,YAAYF,KAAKG,OAAO,CAAC,OAAOC,eAAe,cAAcA,aAAaH,IAAII,aAAa,CAAC,YAAYJ,GAAG;AACjH,MAAMK,cAAcP,WAAWG;AAE/B,OAAO,MAAMK,aAAa,+EAA+E;AAEzG,IAAIC,cAA6B;AAEjC;;;;;;;CAOC,GACD,OAAO,eAAeC;IACpB,uBAAuB;IACvB,IAAID,aAAa;QACf,OAAOA;IACT;IAEA,IAAI;QACF,6BAA6B;QAC7B,MAAME,WAAW,MAAMC,MAAMJ;QAC7B,IAAIG,SAASE,EAAE,EAAE;YACfJ,cAAe,MAAME,SAASG,IAAI;YAClC,OAAOL;QACT;IACF,EAAE,OAAM;IACN,kDAAkD;IACpD;IAEA,6BAA6B;IAC7B,MAAMM,aAAad,KAAKe,IAAI,CAACT,aAAa;IAC1C,IAAI,CAACR,GAAGkB,UAAU,CAACF,aAAa;QAC9B,MAAM,IAAIG,MAAM,sEAAsE;IACxF;IAEAT,cAAcU,KAAKC,KAAK,CAACrB,GAAGsB,YAAY,CAACN,YAAY;IACrD,OAAON;AACT;AAEA;;;;;;CAMC,GACD,OAAO,eAAea,eAAeC,UAAmB,EAAEC,UAAkB;IAC1E,MAAMC,SAAS,MAAMf;IAErB,MAAMgB,MAAM,IAAI7B,IAAI;QAClB8B,WAAW;QACXC,SAAS;QACTC,cAAc;IAChB;IAEA,+DAA+D;IAC/D/B,WAAW4B;IAEX,MAAMI,WAAWJ,IAAIK,OAAO,CAACN;IAC7B,MAAMO,QAAQF,SAASP;IAEvB,IAAI,CAACS,OAAO;YACKF;QAAf,MAAMG,SAASH,EAAAA,mBAAAA,SAASG,MAAM,cAAfH,uCAAAA,iBAAiBI,GAAG,CAAC,CAACC,IAAmB,CAAC,IAAI,EAAEA,EAAEC,YAAY,IAAI,SAAS,CAAC,EAAED,EAAEE,OAAO,EAAE,EAAErB,IAAI,CAAC,UAAS;QAExH,MAAM,IAAIE,MAAM,CAAC,yBAAyB,EAAEM,WAAW,IAAI,EAAES,OAAO,6MAA6M,CAAC;IACpR;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-z/cli",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "CLI tool for managing MCP server clusters and testing workflows.",
   "keywords": [
     "mcp",
@@ -87,11 +87,10 @@
     "node-version-use": "^2.1.6",
     "ts-dev-stack": "^1.21.3",
     "tsds-config": "^1.0.0",
-    "typescript": "^5.9.3",
     "zod": "^4.0.0"
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=20"
   },
   "tsds": {
     "source": "src/index.ts"