@mcp-z/cli 1.0.0

package/dist/cjs/commands/manifest/validate.js

@@ -0,0 +1,525 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "validateCommand", {
+    enumerable: true,
+    get: function() {
+        return validateCommand;
+    }
+});
+var _fs = /*#__PURE__*/ _interop_require_wildcard(require("fs"));
+var _typests = require("../../types.js");
+var _metadatareaderts = require("./metadata-reader.js");
+function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_with_holes(arr) {
+    if (Array.isArray(arr)) return arr;
+}
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
+    try {
+        var info = gen[key](arg);
+        var value = info.value;
+    } catch (error) {
+        reject(error);
+        return;
+    }
+    if (info.done) {
+        resolve(value);
+    } else {
+        Promise.resolve(value).then(_next, _throw);
+    }
+}
+function _async_to_generator(fn) {
+    return function() {
+        var self = this, args = arguments;
+        return new Promise(function(resolve, reject) {
+            var gen = fn.apply(self, args);
+            function _next(value) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value);
+            }
+            function _throw(err) {
+                asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err);
+            }
+            _next(undefined);
+        });
+    };
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+function _iterable_to_array_limit(arr, i) {
+    var _i = arr == null ? null : typeof Symbol !== "undefined" && arr[Symbol.iterator] || arr["@@iterator"];
+    if (_i == null) return;
+    var _arr = [];
+    var _n = true;
+    var _d = false;
+    var _s, _e;
+    try {
+        for(_i = _i.call(arr); !(_n = (_s = _i.next()).done); _n = true){
+            _arr.push(_s.value);
+            if (i && _arr.length === i) break;
+        }
+    } catch (err) {
+        _d = true;
+        _e = err;
+    } finally{
+        try {
+            if (!_n && _i["return"] != null) _i["return"]();
+        } finally{
+            if (_d) throw _e;
+        }
+    }
+    return _arr;
+}
+function _non_iterable_rest() {
+    throw new TypeError("Invalid attempt to destructure non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _sliced_to_array(arr, i) {
+    return _array_with_holes(arr) || _iterable_to_array_limit(arr, i) || _unsupported_iterable_to_array(arr, i) || _non_iterable_rest();
+}
+function _type_of(obj) {
+    "@swc/helpers - typeof";
+    return obj && typeof Symbol !== "undefined" && obj.constructor === Symbol ? "symbol" : typeof obj;
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+function _ts_generator(thisArg, body) {
+    var f, y, t, _ = {
+        label: 0,
+        sent: function() {
+            if (t[0] & 1) throw t[1];
+            return t[1];
+        },
+        trys: [],
+        ops: []
+    }, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype), d = Object.defineProperty;
+    return d(g, "next", {
+        value: verb(0)
+    }), d(g, "throw", {
+        value: verb(1)
+    }), d(g, "return", {
+        value: verb(2)
+    }), typeof Symbol === "function" && d(g, Symbol.iterator, {
+        value: function() {
+            return this;
+        }
+    }), g;
+    function verb(n) {
+        return function(v) {
+            return step([
+                n,
+                v
+            ]);
+        };
+    }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while(g && (g = 0, op[0] && (_ = 0)), _)try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [
+                op[0] & 2,
+                t.value
+            ];
+            switch(op[0]){
+                case 0:
+                case 1:
+                    t = op;
+                    break;
+                case 4:
+                    _.label++;
+                    return {
+                        value: op[1],
+                        done: false
+                    };
+                case 5:
+                    _.label++;
+                    y = op[1];
+                    op = [
+                        0
+                    ];
+                    continue;
+                case 7:
+                    op = _.ops.pop();
+                    _.trys.pop();
+                    continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+                        _ = 0;
+                        continue;
+                    }
+                    if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+                        _.label = op[1];
+                        break;
+                    }
+                    if (op[0] === 6 && _.label < t[1]) {
+                        _.label = t[1];
+                        t = op;
+                        break;
+                    }
+                    if (t && _.label < t[2]) {
+                        _.label = t[2];
+                        _.ops.push(op);
+                        break;
+                    }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop();
+                    continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) {
+            op = [
+                6,
+                e
+            ];
+            y = 0;
+        } finally{
+            f = t = 0;
+        }
+        if (op[0] & 5) throw op[1];
+        return {
+            value: op[0] ? op[1] : void 0,
+            done: true
+        };
+    }
+}
+var metadataReader = new _metadatareaderts.MetadataReader();
+function validateCommand(filePath) {
+    return _async_to_generator(function() {
+        var config, hasErrors, hasWarnings, servers, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, _step_value, serverName, serverConfig, validation, err;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    // 1. Check file exists
+                    if (!_fs.existsSync(filePath)) {
+                        throw Object.assign(new Error("File not found: ".concat(filePath)), {
+                            code: 1
+                        });
+                    }
+                    try {
+                        config = JSON.parse(_fs.readFileSync(filePath, 'utf8'));
+                    } catch (error) {
+                        throw Object.assign(new Error("Invalid JSON: ".concat(_instanceof(error, Error) ? error.message : String(error))), {
+                            code: 1
+                        });
+                    }
+                    // 3. Schema validation - check basic structure
+                    if (!config.mcpServers || _type_of(config.mcpServers) !== 'object') {
+                        throw Object.assign(new Error('Config must have "mcpServers" object'), {
+                            code: 1
+                        });
+                    }
+                    console.log("✅ ".concat(filePath, " has valid JSON structure\n"));
+                    console.log('Server Configuration Validation:\n');
+                    // 4. Validate each server
+                    hasErrors = false;
+                    hasWarnings = false;
+                    servers = Object.entries(config.mcpServers);
+                    if (servers.length === 0) {
+                        console.log('  ⚠️  No servers configured');
+                        return [
+                            2
+                        ];
+                    }
+                    _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        6,
+                        7,
+                        8
+                    ]);
+                    _iterator = servers[Symbol.iterator]();
+                    _state.label = 2;
+                case 2:
+                    if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                        3,
+                        5
+                    ];
+                    _step_value = _sliced_to_array(_step.value, 2), serverName = _step_value[0], serverConfig = _step_value[1];
+                    return [
+                        4,
+                        validateServerConfig(serverName, serverConfig)
+                    ];
+                case 3:
+                    validation = _state.sent();
+                    if (validation.valid) {
+                        console.log("  ✅ ".concat(serverName, ": Valid configuration"));
+                    } else if (validation.severity === 'error') {
+                        console.log("  ❌ ".concat(serverName, ": ").concat(validation.message));
+                        hasErrors = true;
+                    } else {
+                        console.log("  ⚠️  ".concat(serverName, ": ").concat(validation.message));
+                        hasWarnings = true;
+                    }
+                    _state.label = 4;
+                case 4:
+                    _iteratorNormalCompletion = true;
+                    return [
+                        3,
+                        2
+                    ];
+                case 5:
+                    return [
+                        3,
+                        8
+                    ];
+                case 6:
+                    err = _state.sent();
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                    return [
+                        3,
+                        8
+                    ];
+                case 7:
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                    return [
+                        7
+                    ];
+                case 8:
+                    console.log('');
+                    if (hasErrors) {
+                        throw Object.assign(new Error('Validation failed with errors'), {
+                            code: 1
+                        });
+                    }
+                    if (hasWarnings) {
+                        console.log('⚠️  Validation passed with warnings');
+                    } else {
+                        console.log('✅ All validations passed');
+                    }
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+}
+function validateServerConfig(serverName, serverConfig) {
+    return _async_to_generator(function() {
+        var _serverConfig_start, _serverConfig_start1, metadata, error, transport, pkg, envToCheck, missingEnvVars, varNames, argsToCheck, validArgNames, unknownArgs;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    // Check basic structure based on server type
+                    if ((0, _typests.isHttpServer)(serverConfig)) {
+                        // HTTP server validation
+                        if (!serverConfig.url) {
+                            return [
+                                2,
+                                {
+                                    valid: false,
+                                    severity: 'error',
+                                    message: 'HTTP server missing required "url" field'
+                                }
+                            ];
+                        }
+                        // If has start block, validate it
+                        if (serverConfig.start) {
+                            if (!serverConfig.start.command) {
+                                return [
+                                    2,
+                                    {
+                                        valid: false,
+                                        severity: 'error',
+                                        message: 'HTTP server "start" block missing required "command" field'
+                                    }
+                                ];
+                            }
+                            if (serverConfig.start.args !== undefined && !Array.isArray(serverConfig.start.args)) {
+                                return [
+                                    2,
+                                    {
+                                        valid: false,
+                                        severity: 'error',
+                                        message: 'HTTP server "start.args" field must be an array'
+                                    }
+                                ];
+                            }
+                        }
+                    } else {
+                        // Stdio server validation
+                        if (!serverConfig.command) {
+                            return [
+                                2,
+                                {
+                                    valid: false,
+                                    severity: 'error',
+                                    message: 'Stdio server missing required "command" field'
+                                }
+                            ];
+                        }
+                        if (serverConfig.args !== undefined && !Array.isArray(serverConfig.args)) {
+                            return [
+                                2,
+                                {
+                                    valid: false,
+                                    severity: 'error',
+                                    message: 'Stdio server "args" field must be an array'
+                                }
+                            ];
+                        }
+                    }
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        3,
+                        ,
+                        4
+                    ]);
+                    return [
+                        4,
+                        metadataReader.readServerMetadata(serverName)
+                    ];
+                case 2:
+                    metadata = _state.sent();
+                    return [
+                        3,
+                        4
+                    ];
+                case 3:
+                    error = _state.sent();
+                    return [
+                        2,
+                        {
+                            valid: false,
+                            severity: 'warning',
+                            message: "Cannot verify: server package not found (".concat(_instanceof(error, Error) ? error.message : String(error), ")")
+                        }
+                    ];
+                case 4:
+                    // Detect transport using type guard
+                    transport = (0, _typests.isHttpServer)(serverConfig) ? 'streamable-http' : 'stdio';
+                    // Get package config from server.json
+                    pkg = metadataReader.getPackageForTransport(metadata, transport);
+                    if (!pkg) {
+                        return [
+                            2,
+                            {
+                                valid: false,
+                                severity: 'error',
+                                message: "No ".concat(transport, " transport configuration found in server.json")
+                            }
+                        ];
+                    }
+                    // Determine which env to check based on server type
+                    envToCheck = (0, _typests.isStdioServer)(serverConfig) ? serverConfig.env : (_serverConfig_start = serverConfig.start) === null || _serverConfig_start === void 0 ? void 0 : _serverConfig_start.env;
+                    // Check for missing required env vars (based on server.json)
+                    missingEnvVars = pkg.environmentVariables.filter(function(v) {
+                        if (!v.isRequired) return false; // Skip optional vars
+                        var envValue = envToCheck === null || envToCheck === void 0 ? void 0 : envToCheck[v.name];
+                        // Consider it missing if it's not set or is a placeholder like ${VAR_NAME}
+                        return !envValue || envValue.match(/^\$\{.*\}$/);
+                    });
+                    if (missingEnvVars.length > 0) {
+                        varNames = missingEnvVars.map(function(v) {
+                            return v.name;
+                        }).join(', ');
+                        return [
+                            2,
+                            {
+                                valid: false,
+                                severity: 'warning',
+                                message: "Missing or placeholder required env vars: ".concat(varNames)
+                            }
+                        ];
+                    }
+                    // Get args to validate based on server type
+                    argsToCheck = (0, _typests.isStdioServer)(serverConfig) ? serverConfig.args || [] : ((_serverConfig_start1 = serverConfig.start) === null || _serverConfig_start1 === void 0 ? void 0 : _serverConfig_start1.args) || [];
+                    // Get valid args from server.json
+                    validArgNames = new Set(pkg.packageArguments.map(function(a) {
+                        return a.name;
+                    }));
+                    // Check for unknown/outdated args
+                    unknownArgs = argsToCheck.filter(function(arg) {
+                        if (!arg.startsWith('--')) return false; // Not a flag
+                        var argName = arg.split('=')[0]; // Get just the flag name
+                        if (!argName) return false; // Skip if somehow empty
+                        return !validArgNames.has(argName);
+                    });
+                    if (unknownArgs.length > 0) {
+                        return [
+                            2,
+                            {
+                                valid: false,
+                                severity: 'warning',
+                                message: "Unknown arguments: ".concat(unknownArgs.join(', '), ". May be outdated - consider regenerating config.")
+                            }
+                        ];
+                    }
+                    return [
+                        2,
+                        {
+                            valid: true
+                        }
+                    ];
+            }
+        });
+    })();
+}
+/* CJS INTEROP */ if (exports.__esModule && exports.default) { try { Object.defineProperty(exports.default, '__esModule', { value: true }); for (var key in exports) { exports.default[key] = exports[key]; } } catch (_) {}; module.exports = exports.default; }

package/dist/cjs/commands/manifest/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/commands/manifest/validate.ts"],"sourcesContent":["import * as fs from 'fs';\nimport type { MCPConfiguration, ServerConfig } from '../../types.ts';\nimport { isHttpServer, isStdioServer } from '../../types.ts';\nimport { MetadataReader, type ServerMetadata } from './metadata-reader.ts';\n\ninterface ValidationResult {\n  valid: boolean;\n  severity?: 'error' | 'warning';\n  message?: string;\n}\n\nconst metadataReader = new MetadataReader();\n\nexport async function validateCommand(filePath: string): Promise<void> {\n  // 1. Check file exists\n  if (!fs.existsSync(filePath)) {\n    throw Object.assign(new Error(`File not found: ${filePath}`), { code: 1 });\n  }\n\n  // 2. JSON syntax validation\n  let config: MCPConfiguration;\n  try {\n    config = JSON.parse(fs.readFileSync(filePath, 'utf8')) as MCPConfiguration;\n  } catch (error) {\n    throw Object.assign(new Error(`Invalid JSON: ${error instanceof Error ? error.message : String(error)}`), {\n      code: 1,\n    });\n  }\n\n  // 3. Schema validation - check basic structure\n  if (!config.mcpServers || typeof config.mcpServers !== 'object') {\n    throw Object.assign(new Error('Config must have \"mcpServers\" object'), { code: 1 });\n  }\n\n  console.log(`✅ ${filePath} has valid JSON structure\\n`);\n  console.log('Server Configuration Validation:\\n');\n\n  // 4. Validate each server\n  let hasErrors = false;\n  let hasWarnings = false;\n\n  const servers = Object.entries(config.mcpServers);\n\n  if (servers.length === 0) {\n    console.log('  ⚠️  No servers configured');\n    return;\n  }\n\n  for (const [serverName, serverConfig] of servers) {\n    const validation = await validateServerConfig(serverName, serverConfig);\n\n    if (validation.valid) {\n      console.log(`  ✅ ${serverName}: Valid configuration`);\n    } else if (validation.severity === 'error') {\n      console.log(`  ❌ ${serverName}: ${validation.message}`);\n      hasErrors = true;\n    } else {\n      console.log(`  ⚠️  ${serverName}: ${validation.message}`);\n      hasWarnings = true;\n    }\n  }\n\n  console.log('');\n\n  if (hasErrors) {\n    throw Object.assign(new Error('Validation failed with errors'), { code: 1 });\n  }\n\n  if (hasWarnings) {\n    console.log('⚠️  Validation passed with warnings');\n  } else {\n    console.log('✅ All validations passed');\n  }\n}\n\nasync function validateServerConfig(serverName: string, serverConfig: ServerConfig): Promise<ValidationResult> {\n  // Check basic structure based on server type\n  if (isHttpServer(serverConfig)) {\n    // HTTP server validation\n    if (!serverConfig.url) {\n      return {\n        valid: false,\n        severity: 'error',\n        message: 'HTTP server missing required \"url\" field',\n      };\n    }\n    // If has start block, validate it\n    if (serverConfig.start) {\n      if (!serverConfig.start.command) {\n        return {\n          valid: false,\n          severity: 'error',\n          message: 'HTTP server \"start\" block missing required \"command\" field',\n        };\n      }\n      if (serverConfig.start.args !== undefined && !Array.isArray(serverConfig.start.args)) {\n        return {\n          valid: false,\n          severity: 'error',\n          message: 'HTTP server \"start.args\" field must be an array',\n        };\n      }\n    }\n  } else {\n    // Stdio server validation\n    if (!serverConfig.command) {\n      return {\n        valid: false,\n        severity: 'error',\n        message: 'Stdio server missing required \"command\" field',\n      };\n    }\n    if (serverConfig.args !== undefined && !Array.isArray(serverConfig.args)) {\n      return {\n        valid: false,\n        severity: 'error',\n        message: 'Stdio server \"args\" field must be an array',\n      };\n    }\n  }\n\n  // Try to load server metadata\n  let metadata: ServerMetadata;\n  try {\n    metadata = await metadataReader.readServerMetadata(serverName);\n  } catch (error) {\n    return {\n      valid: false,\n      severity: 'warning',\n      message: `Cannot verify: server package not found (${error instanceof Error ? error.message : String(error)})`,\n    };\n  }\n\n  // Detect transport using type guard\n  const transport = isHttpServer(serverConfig) ? 'streamable-http' : 'stdio';\n\n  // Get package config from server.json\n  const pkg = metadataReader.getPackageForTransport(metadata, transport as 'stdio' | 'streamable-http');\n  if (!pkg) {\n    return {\n      valid: false,\n      severity: 'error',\n      message: `No ${transport} transport configuration found in server.json`,\n    };\n  }\n\n  // Determine which env to check based on server type\n  const envToCheck = isStdioServer(serverConfig) ? serverConfig.env : serverConfig.start?.env;\n\n  // Check for missing required env vars (based on server.json)\n  const missingEnvVars = pkg.environmentVariables.filter((v) => {\n    if (!v.isRequired) return false; // Skip optional vars\n    const envValue = envToCheck?.[v.name];\n    // Consider it missing if it's not set or is a placeholder like ${VAR_NAME}\n    return !envValue || envValue.match(/^\\$\\{.*\\}$/);\n  });\n\n  if (missingEnvVars.length > 0) {\n    const varNames = missingEnvVars.map((v) => v.name).join(', ');\n    return {\n      valid: false,\n      severity: 'warning',\n      message: `Missing or placeholder required env vars: ${varNames}`,\n    };\n  }\n\n  // Get args to validate based on server type\n  const argsToCheck = isStdioServer(serverConfig) ? serverConfig.args || [] : serverConfig.start?.args || [];\n\n  // Get valid args from server.json\n  const validArgNames = new Set(pkg.packageArguments.map((a) => a.name));\n\n  // Check for unknown/outdated args\n  const unknownArgs = argsToCheck.filter((arg: string) => {\n    if (!arg.startsWith('--')) return false; // Not a flag\n    const argName = arg.split('=')[0]; // Get just the flag name\n    if (!argName) return false; // Skip if somehow empty\n    return !validArgNames.has(argName);\n  });\n\n  if (unknownArgs.length > 0) {\n    return {\n      valid: false,\n      severity: 'warning',\n      message: `Unknown arguments: ${unknownArgs.join(', ')}. May be outdated - consider regenerating config.`,\n    };\n  }\n\n  return { valid: true };\n}\n"],"names":["validateCommand","metadataReader","MetadataReader","filePath","config","hasErrors","hasWarnings","servers","serverName","serverConfig","validation","fs","existsSync","Object","assign","Error","code","JSON","parse","readFileSync","error","message","String","mcpServers","console","log","entries","length","validateServerConfig","valid","severity","metadata","transport","pkg","envToCheck","missingEnvVars","varNames","argsToCheck","validArgNames","unknownArgs","isHttpServer","url","start","command","args","undefined","Array","isArray","readServerMetadata","getPackageForTransport","isStdioServer","env","environmentVariables","filter","v","isRequired","envValue","name","match","map","join","Set","packageArguments","a","arg","startsWith","argName","split","has"],"mappings":"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"}

package/dist/cjs/commands/read-resource.d.cts

@@ -0,0 +1,24 @@
+/**
+ * read-resource.ts
+ *
+ * Read MCP resources from the command line.
+ * Supports stdio (spawned) and http (remote) servers per MCP spec.
+ */
+import { type InlineConfigOptions } from '../lib/resolve-server-config.js';
+export interface ReadResourceOptions extends InlineConfigOptions {
+    uri: string;
+    json?: boolean;
+}
+/**
+ * Main read-resource command implementation.
+ *
+ * @param opts - Read resource options from CLI flags
+ *
+ * @example
+ * // Read a resource by URI
+ * await readResourceCommand({
+ *   server: 'gmail',
+ *   uri: 'gmail://messages/abc123',
+ * });
+ */
+export declare function readResourceCommand(opts: ReadResourceOptions): Promise<void>;

package/dist/cjs/commands/read-resource.d.ts

@@ -0,0 +1,24 @@
+/**
+ * read-resource.ts
+ *
+ * Read MCP resources from the command line.
+ * Supports stdio (spawned) and http (remote) servers per MCP spec.
+ */
+import { type InlineConfigOptions } from '../lib/resolve-server-config.js';
+export interface ReadResourceOptions extends InlineConfigOptions {
+    uri: string;
+    json?: boolean;
+}
+/**
+ * Main read-resource command implementation.
+ *
+ * @param opts - Read resource options from CLI flags
+ *
+ * @example
+ * // Read a resource by URI
+ * await readResourceCommand({
+ *   server: 'gmail',
+ *   uri: 'gmail://messages/abc123',
+ * });
+ */
+export declare function readResourceCommand(opts: ReadResourceOptions): Promise<void>;