@mcp-z/cli 1.0.0

package/dist/cjs/cli.js

@@ -0,0 +1,576 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return cli;
+    }
+});
+var _commander = require("commander");
+var _fs = /*#__PURE__*/ _interop_require_wildcard(require("fs"));
+var _modulerootsync = /*#__PURE__*/ _interop_require_default(require("module-root-sync"));
+var _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
+var _url = /*#__PURE__*/ _interop_require_wildcard(require("url"));
+var _calltoolts = require("./commands/call-tool.js");
+var _getpromptts = require("./commands/get-prompt.js");
+var _inspectts = require("./commands/inspect.js");
+var _indexts = require("./commands/manifest/index.js");
+var _readresourcets = require("./commands/read-resource.js");
+var _searchts = require("./commands/search.js");
+var _upts = require("./commands/up.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_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(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 _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _instanceof(left, right) {
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
+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();
+    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(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter);
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _object_spread(target) {
+    for(var i = 1; i < arguments.length; i++){
+        var source = arguments[i] != null ? arguments[i] : {};
+        var ownKeys = Object.keys(source);
+        if (typeof Object.getOwnPropertySymbols === "function") {
+            ownKeys = ownKeys.concat(Object.getOwnPropertySymbols(source).filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(source, sym).enumerable;
+            }));
+        }
+        ownKeys.forEach(function(key) {
+            _define_property(target, key, source[key]);
+        });
+    }
+    return target;
+}
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) {
+        Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    } else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+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 pkg = JSON.parse(_fs.readFileSync(_path.join((0, _modulerootsync.default)(_url.fileURLToPath(require("url").pathToFileURL(__filename).toString())), 'package.json'), 'utf-8'));
+function cli(argv, programName) {
+    var program = new _commander.Command();
+    program.name(programName).description('mcp-z helper CLI').version(pkg.version);
+    program.command('up').description('Start MCP server cluster (starts all servers by default)').option('--config <path>', 'Config file path (searches up to home directory)').option('--stdio-only', 'Start only stdio servers (Claude Code compatible)').option('--http-only', 'Start only HTTP servers with start blocks (Claude Code Desktop)').action(function(options) {
+        return _async_to_generator(function() {
+            var clusterResult, shutdown, error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            3,
+                            ,
+                            4
+                        ]);
+                        return [
+                            4,
+                            (0, _upts.upCommand)({
+                                config: options.config,
+                                stdioOnly: options.stdioOnly,
+                                httpOnly: options.httpOnly
+                            })
+                        ];
+                    case 1:
+                        clusterResult = _state.sent();
+                        // If httpOnly mode and no servers were spawned, exit immediately
+                        if (options.httpOnly && clusterResult.servers.size === 0) process.exit(0);
+                        shutdown = function(sig) {
+                            return _async_to_generator(function() {
+                                var _;
+                                return _ts_generator(this, function(_state) {
+                                    switch(_state.label){
+                                        case 0:
+                                            console.log('Shutting down (signal=', sig, ')');
+                                            if (!(clusterResult && typeof clusterResult.close === 'function')) return [
+                                                3,
+                                                4
+                                            ];
+                                            _state.label = 1;
+                                        case 1:
+                                            _state.trys.push([
+                                                1,
+                                                3,
+                                                ,
+                                                4
+                                            ]);
+                                            return [
+                                                4,
+                                                clusterResult.close(sig === 'SIGTERM' ? 'SIGTERM' : 'SIGINT', {
+                                                    timeoutMs: 1000
+                                                })
+                                            ];
+                                        case 2:
+                                            _state.sent();
+                                            return [
+                                                3,
+                                                4
+                                            ];
+                                        case 3:
+                                            _ = _state.sent();
+                                            return [
+                                                3,
+                                                4
+                                            ];
+                                        case 4:
+                                            process.exit(0);
+                                            return [
+                                                2
+                                            ];
+                                    }
+                                });
+                            })();
+                        };
+                        // Signal handlers trigger async shutdown then exit
+                        process.on('SIGINT', function() {
+                            shutdown('SIGINT').catch(function() {
+                                return process.exit(1);
+                            });
+                        });
+                        process.on('SIGTERM', function() {
+                            shutdown('SIGTERM').catch(function() {
+                                return process.exit(1);
+                            });
+                        });
+                        // Keep process alive - wait for signal
+                        return [
+                            4,
+                            new Promise(function() {})
+                        ];
+                    case 2:
+                        _state.sent();
+                        return [
+                            3,
+                            4
+                        ];
+                    case 3:
+                        error = _state.sent();
+                        console.error("\n❌ ".concat(_instanceof(error, Error) ? error.message : String(error)));
+                        process.exit(1);
+                        return [
+                            3,
+                            4
+                        ];
+                    case 4:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    program.command('inspect').description('Inspect MCP servers: explore tools, resources, prompts, and health status').option('--config <path>', 'Config file path (searches up to home directory)').option('--servers <list>', 'Comma-separated server names to inspect').option('--tools', 'Show tools only').option('--resources', 'Show resources only').option('--prompts', 'Show prompts only').option('--health', 'Show health diagnostics only').option('--json', 'Output as JSON').option('--verbose', 'Include detailed schemas').option('--attach', 'Connect to running servers (default: spawn servers)').action(function(options) {
+        return _async_to_generator(function() {
+            var error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            (0, _inspectts.inspectCommand)({
+                                config: options.config,
+                                servers: options.servers,
+                                tools: options.tools,
+                                resources: options.resources,
+                                prompts: options.prompts,
+                                health: options.health,
+                                json: options.json,
+                                verbose: options.verbose,
+                                attach: options.attach
+                            })
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            3,
+                            3
+                        ];
+                    case 2:
+                        error = _state.sent();
+                        console.error("\n❌ ".concat(_instanceof(error, Error) ? error.message : String(error)));
+                        process.exit(1);
+                        return [
+                            3,
+                            3
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    program.command('call-tool [server] <tool> <args>').description('Execute an MCP tool with JSON arguments').option('--config <path>', 'Custom config file path (default: .mcp.json)').option('--run <cmd>', 'Stdio run command (e.g., "npx -y @echo/server")').option('--url <url>', 'HTTP server URL').option('--server <json>', 'Full server config as JSON').option('--json', 'Output as JSON').action(function(server, tool, args, options) {
+        return _async_to_generator(function() {
+            var opts;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        // Handle case where server is actually the tool when using inline config
+                        // Commander parses: call-tool [server] <tool> <args>
+                        // With --run: server=undefined, tool=actualTool, args=actualArgs
+                        // Without --run: server=serverName, tool=actualTool, args=actualArgs
+                        opts = _object_spread_props(_object_spread({
+                            server: server,
+                            tool: tool,
+                            args: args
+                        }, options), {
+                            run: options.run,
+                            serverConfig: options.server
+                        });
+                        return [
+                            4,
+                            (0, _calltoolts.callToolCommand)(opts)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    program.command('read-resource [server] <uri>').description('Read an MCP resource by URI').option('--config <path>', 'Custom config file path (default: .mcp.json)').option('--run <cmd>', 'Stdio run command (e.g., "npx -y @echo/server")').option('--url <url>', 'HTTP server URL').option('--server <json>', 'Full server config as JSON').option('--json', 'Output as JSON').action(function(server, uri, options) {
+        return _async_to_generator(function() {
+            var opts;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        opts = _object_spread_props(_object_spread({
+                            server: server,
+                            uri: uri
+                        }, options), {
+                            run: options.run,
+                            serverConfig: options.server
+                        });
+                        return [
+                            4,
+                            (0, _readresourcets.readResourceCommand)(opts)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    program.command('get-prompt [server] <name> [args]').description('Get an MCP prompt with optional JSON arguments').option('--config <path>', 'Custom config file path (default: .mcp.json)').option('--run <cmd>', 'Stdio run command (e.g., "npx -y @echo/server")').option('--url <url>', 'HTTP server URL').option('--server <json>', 'Full server config as JSON').option('--json', 'Output as JSON').action(function(server, name, args, options) {
+        return _async_to_generator(function() {
+            var opts;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        opts = _object_spread_props(_object_spread({
+                            server: server,
+                            name: name,
+                            args: args || '{}'
+                        }, options), {
+                            run: options.run,
+                            serverConfig: options.server
+                        });
+                        return [
+                            4,
+                            (0, _getpromptts.getPromptCommand)(opts)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    program.command('search <query>').description('Search for tools, prompts, and resources across MCP servers').option('--config <path>', 'Custom config file path (default: .mcp.json)').option('--servers <list>', 'Comma-separated server names to search').option('--types <list>', 'Comma-separated types: tool,prompt,resource (default: all)').option('--fields <list>', 'Comma-separated fields: name,description,schema,server (default: name,description,schema)').option('--limit <number>', 'Maximum results to return (default: 20)', Number.parseInt).option('--threshold <number>', 'Minimum relevance score 0-1 (default: 0)', Number.parseFloat).option('--json', 'Output as JSON').option('--attach', 'Connect to running servers (default: spawn servers)').action(function(query, options) {
+        return _async_to_generator(function() {
+            var error;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            (0, _searchts.searchCommand)(query, options)
+                        ];
+                    case 1:
+                        _state.sent();
+                        return [
+                            3,
+                            3
+                        ];
+                    case 2:
+                        error = _state.sent();
+                        console.error("\n❌ ".concat(_instanceof(error, Error) ? error.message : String(error)));
+                        process.exit(1);
+                        return [
+                            3,
+                            3
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    // Add config command
+    program.addCommand((0, _indexts.createManifestCommand)());
+    program.parse([
+        'node',
+        'cli'
+    ].concat(_to_consumable_array(argv)));
+}
+if (require("url").pathToFileURL(__filename).toString().startsWith('file:')) {
+    var modulePath = (0, _url.fileURLToPath)(require("url").pathToFileURL(__filename).toString());
+    if (process.argv[1] === modulePath || process.argv[1] === modulePath.replace(/\.ts$/, '.js')) {
+        cli(process.argv.slice(2), 'mcp-z');
+    }
+}
+/* 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/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/cli.ts"],"sourcesContent":["import { Command } from 'commander';\nimport * as fs from 'fs';\nimport moduleRoot from 'module-root-sync';\nimport * as path from 'path';\nimport * as url from 'url';\nimport { type CallToolOptions, callToolCommand } from './commands/call-tool.ts';\nimport { type GetPromptOptions, getPromptCommand } from './commands/get-prompt.ts';\nimport { inspectCommand } from './commands/inspect.ts';\nimport { createManifestCommand } from './commands/manifest/index.ts';\nimport { type ReadResourceOptions, readResourceCommand } from './commands/read-resource.ts';\nimport { searchCommand } from './commands/search.ts';\nimport { upCommand } from './commands/up.ts';\n\nconst pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));\n\nexport default function cli(argv: string[], programName: string) {\n  const program = new Command();\n  program.name(programName).description('mcp-z helper CLI').version(pkg.version);\n\n  program\n    .command('up')\n    .description('Start MCP server cluster (starts all servers by default)')\n    .option('--config <path>', 'Config file path (searches up to home directory)')\n    .option('--stdio-only', 'Start only stdio servers (Claude Code compatible)')\n    .option('--http-only', 'Start only HTTP servers with start blocks (Claude Code Desktop)')\n    .action(async (options) => {\n      try {\n        const clusterResult = await upCommand({ config: options.config, stdioOnly: options.stdioOnly, httpOnly: options.httpOnly });\n\n        // If httpOnly mode and no servers were spawned, exit immediately\n        if (options.httpOnly && clusterResult.servers.size === 0) process.exit(0);\n\n        const shutdown = async (sig: string) => {\n          console.log('Shutting down (signal=', sig, ')');\n          if (clusterResult && typeof clusterResult.close === 'function') {\n            try {\n              await clusterResult.close(sig === 'SIGTERM' ? 'SIGTERM' : 'SIGINT', { timeoutMs: 1000 });\n            } catch (_) {\n              /* ignore */\n            }\n          }\n          process.exit(0);\n        };\n\n        // Signal handlers trigger async shutdown then exit\n        process.on('SIGINT', () => {\n          shutdown('SIGINT').catch(() => process.exit(1));\n        });\n        process.on('SIGTERM', () => {\n          shutdown('SIGTERM').catch(() => process.exit(1));\n        });\n\n        // Keep process alive - wait for signal\n        await new Promise(() => {});\n      } catch (error) {\n        console.error(`\\n❌ ${error instanceof Error ? error.message : String(error)}`);\n        process.exit(1);\n      }\n    });\n\n  program\n    .command('inspect')\n    .description('Inspect MCP servers: explore tools, resources, prompts, and health status')\n    .option('--config <path>', 'Config file path (searches up to home directory)')\n    .option('--servers <list>', 'Comma-separated server names to inspect')\n    .option('--tools', 'Show tools only')\n    .option('--resources', 'Show resources only')\n    .option('--prompts', 'Show prompts only')\n    .option('--health', 'Show health diagnostics only')\n    .option('--json', 'Output as JSON')\n    .option('--verbose', 'Include detailed schemas')\n    .option('--attach', 'Connect to running servers (default: spawn servers)')\n    .action(async (options) => {\n      try {\n        await inspectCommand({ config: options.config, servers: options.servers, tools: options.tools, resources: options.resources, prompts: options.prompts, health: options.health, json: options.json, verbose: options.verbose, attach: options.attach });\n      } catch (error) {\n        console.error(`\\n❌ ${error instanceof Error ? error.message : String(error)}`);\n        process.exit(1);\n      }\n    });\n\n  program\n    .command('call-tool [server] <tool> <args>')\n    .description('Execute an MCP tool with JSON arguments')\n    .option('--config <path>', 'Custom config file path (default: .mcp.json)')\n    .option('--run <cmd>', 'Stdio run command (e.g., \"npx -y @echo/server\")')\n    .option('--url <url>', 'HTTP server URL')\n    .option('--server <json>', 'Full server config as JSON')\n    .option('--json', 'Output as JSON')\n    .action(async (server: string | undefined, tool: string, args: string, options: Omit<CallToolOptions, 'server' | 'tool' | 'args'> & { server?: string; run?: string }) => {\n      // Handle case where server is actually the tool when using inline config\n      // Commander parses: call-tool [server] <tool> <args>\n      // With --run: server=undefined, tool=actualTool, args=actualArgs\n      // Without --run: server=serverName, tool=actualTool, args=actualArgs\n      const opts: CallToolOptions = {\n        server,\n        tool,\n        args,\n        ...options,\n        run: options.run,\n        serverConfig: options.server, // Rename --server to serverConfig to avoid conflict\n      };\n      await callToolCommand(opts);\n    });\n\n  program\n    .command('read-resource [server] <uri>')\n    .description('Read an MCP resource by URI')\n    .option('--config <path>', 'Custom config file path (default: .mcp.json)')\n    .option('--run <cmd>', 'Stdio run command (e.g., \"npx -y @echo/server\")')\n    .option('--url <url>', 'HTTP server URL')\n    .option('--server <json>', 'Full server config as JSON')\n    .option('--json', 'Output as JSON')\n    .action(async (server: string | undefined, uri: string, options: Omit<ReadResourceOptions, 'server' | 'uri'> & { server?: string; run?: string }) => {\n      const opts: ReadResourceOptions = {\n        server,\n        uri,\n        ...options,\n        run: options.run,\n        serverConfig: options.server, // Rename --server to serverConfig to avoid conflict\n      };\n      await readResourceCommand(opts);\n    });\n\n  program\n    .command('get-prompt [server] <name> [args]')\n    .description('Get an MCP prompt with optional JSON arguments')\n    .option('--config <path>', 'Custom config file path (default: .mcp.json)')\n    .option('--run <cmd>', 'Stdio run command (e.g., \"npx -y @echo/server\")')\n    .option('--url <url>', 'HTTP server URL')\n    .option('--server <json>', 'Full server config as JSON')\n    .option('--json', 'Output as JSON')\n    .action(async (server: string | undefined, name: string, args: string | undefined, options: Omit<GetPromptOptions, 'server' | 'name' | 'args'> & { server?: string; run?: string }) => {\n      const opts: GetPromptOptions = {\n        server,\n        name,\n        args: args || '{}',\n        ...options,\n        run: options.run,\n        serverConfig: options.server, // Rename --server to serverConfig to avoid conflict\n      };\n      await getPromptCommand(opts);\n    });\n\n  program\n    .command('search <query>')\n    .description('Search for tools, prompts, and resources across MCP servers')\n    .option('--config <path>', 'Custom config file path (default: .mcp.json)')\n    .option('--servers <list>', 'Comma-separated server names to search')\n    .option('--types <list>', 'Comma-separated types: tool,prompt,resource (default: all)')\n    .option('--fields <list>', 'Comma-separated fields: name,description,schema,server (default: name,description,schema)')\n    .option('--limit <number>', 'Maximum results to return (default: 20)', Number.parseInt)\n    .option('--threshold <number>', 'Minimum relevance score 0-1 (default: 0)', Number.parseFloat)\n    .option('--json', 'Output as JSON')\n    .option('--attach', 'Connect to running servers (default: spawn servers)')\n    .action(async (query: string, options) => {\n      try {\n        await searchCommand(query, options);\n      } catch (error) {\n        console.error(`\\n❌ ${error instanceof Error ? error.message : String(error)}`);\n        process.exit(1);\n      }\n    });\n\n  // Add config command\n  program.addCommand(createManifestCommand());\n\n  program.parse(['node', 'cli', ...argv]);\n}\n\n// Entry point: run CLI when executed directly (not imported)\nimport { fileURLToPath } from 'url';\n\nif (import.meta.url.startsWith('file:')) {\n  const modulePath = fileURLToPath(import.meta.url);\n  if (process.argv[1] === modulePath || process.argv[1] === modulePath.replace(/\\.ts$/, '.js')) {\n    cli(process.argv.slice(2), 'mcp-z');\n  }\n}\n"],"names":["cli","pkg","JSON","parse","fs","readFileSync","path","join","moduleRoot","url","fileURLToPath","argv","programName","program","Command","name","description","version","command","option","action","options","clusterResult","shutdown","error","upCommand","config","stdioOnly","httpOnly","servers","size","process","exit","sig","_","console","log","close","timeoutMs","on","catch","Promise","Error","message","String","inspectCommand","tools","resources","prompts","health","json","verbose","attach","server","tool","args","opts","run","serverConfig","callToolCommand","uri","readResourceCommand","getPromptCommand","Number","parseInt","parseFloat","query","searchCommand","addCommand","createManifestCommand","startsWith","modulePath","replace","slice"],"mappings":"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"}

package/dist/cjs/commands/call-tool.d.cts

@@ -0,0 +1,26 @@
+/**
+ * call-tool.ts
+ *
+ * Execute MCP tools 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 CallToolOptions extends InlineConfigOptions {
+    tool: string;
+    args: string;
+    json?: boolean;
+}
+/**
+ * Main call-tool command implementation.
+ *
+ * @param opts - Call tool options from CLI flags
+ *
+ * @example
+ * // Call a tool with JSON args
+ * await callToolCommand({
+ *   server: 'echo',
+ *   tool: 'echo',
+ *   args: '{"message": "hello"}',
+ * });
+ */
+export declare function callToolCommand(opts: CallToolOptions): Promise<void>;

package/dist/cjs/commands/call-tool.d.ts

@@ -0,0 +1,26 @@
+/**
+ * call-tool.ts
+ *
+ * Execute MCP tools 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 CallToolOptions extends InlineConfigOptions {
+    tool: string;
+    args: string;
+    json?: boolean;
+}
+/**
+ * Main call-tool command implementation.
+ *
+ * @param opts - Call tool options from CLI flags
+ *
+ * @example
+ * // Call a tool with JSON args
+ * await callToolCommand({
+ *   server: 'echo',
+ *   tool: 'echo',
+ *   args: '{"message": "hello"}',
+ * });
+ */
+export declare function callToolCommand(opts: CallToolOptions): Promise<void>;