@mcp-z/cli 1.0.0

package/dist/cjs/commands/read-resource.js

@@ -0,0 +1,311 @@
+/**
+ * read-resource.ts
+ *
+ * Read MCP resources from the command line.
+ * Supports stdio (spawned) and http (remote) servers per MCP spec.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "readResourceCommand", {
+    enumerable: true,
+    get: function() {
+        return readResourceCommand;
+    }
+});
+var _client = require("@mcp-z/client");
+var _resolveserverconfigts = require("../lib/resolve-server-config.js");
+var _typests = require("../types.js");
+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 _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
+        };
+    }
+}
+function readResourceCommand(opts) {
+    return _async_to_generator(function() {
+        var registry, client, _resolveServerConfig, serverName, serverConfig, configDir, start, elapsed, resourceResponse, resource, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, content, error, _;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    _state.trys.push([
+                        0,
+                        3,
+                        4,
+                        9
+                    ]);
+                    // 1. Resolve server configuration (from config file or inline options)
+                    _resolveServerConfig = (0, _resolveserverconfigts.resolveServerConfig)(opts), serverName = _resolveServerConfig.serverName, serverConfig = _resolveServerConfig.serverConfig, configDir = _resolveServerConfig.configDir;
+                    // 2. Create registry and connect
+                    start = Date.now();
+                    if ((0, _typests.isHttpServer)(serverConfig)) {
+                        // HTTP server - no spawning needed
+                        if (!opts.json) {
+                            console.log("\uD83D\uDD17 Connecting to ".concat(serverName, "..."));
+                        }
+                    } else {
+                        // Stdio server - will be spawned
+                        if (!opts.json) {
+                            console.log("\uD83D\uDE80 Spawning ".concat(serverName, " server..."));
+                        }
+                        if (!serverConfig.command) {
+                            throw new Error("Stdio server ".concat(serverName, ' missing required "command" field'));
+                        }
+                    }
+                    // Create registry (spawns stdio servers, registers HTTP servers)
+                    registry = (0, _client.createServerRegistry)(_define_property({}, serverName, serverConfig), {
+                        cwd: configDir
+                    });
+                    return [
+                        4,
+                        registry.connect(serverName)
+                    ];
+                case 1:
+                    client = _state.sent();
+                    if (!(0, _typests.isHttpServer)(serverConfig) && !opts.json) {
+                        elapsed = ((Date.now() - start) / 1000).toFixed(1);
+                        console.log("✓ Server ready in ".concat(elapsed, "s\n"));
+                    }
+                    // 5. Read resource
+                    if (!opts.json) {
+                        console.log("\uD83D\uDCD6 Reading ".concat(opts.uri, "..."));
+                    }
+                    return [
+                        4,
+                        client.readResource(opts.uri)
+                    ];
+                case 2:
+                    resourceResponse = _state.sent();
+                    resource = resourceResponse.raw();
+                    // Success case
+                    if (opts.json) {
+                        // JSON output mode
+                        console.log(JSON.stringify(resource, null, 2));
+                    } else {
+                        // Human-readable output
+                        console.log('✅ Read succeeded\n');
+                        _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                        try {
+                            // Display contents
+                            for(_iterator = resource.contents[Symbol.iterator](); !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+                                content = _step.value;
+                                if ('text' in content) {
+                                    console.log('Content:');
+                                    console.log(content.text);
+                                } else if ('blob' in content) {
+                                    console.log("Blob content (".concat(content.mimeType || 'unknown type', "): ").concat(content.blob.length, " bytes"));
+                                }
+                            }
+                        } catch (err) {
+                            _didIteratorError = true;
+                            _iteratorError = err;
+                        } finally{
+                            try {
+                                if (!_iteratorNormalCompletion && _iterator.return != null) {
+                                    _iterator.return();
+                                }
+                            } finally{
+                                if (_didIteratorError) {
+                                    throw _iteratorError;
+                                }
+                            }
+                        }
+                    }
+                    return [
+                        3,
+                        9
+                    ];
+                case 3:
+                    error = _state.sent();
+                    if (opts.json) {
+                        console.log(JSON.stringify({
+                            error: _instanceof(error, Error) ? error.message : String(error)
+                        }, null, 2));
+                    } else {
+                        console.error("\n❌ ".concat(_instanceof(error, Error) ? error.message : String(error)));
+                    }
+                    throw error;
+                case 4:
+                    if (!registry) return [
+                        3,
+                        8
+                    ];
+                    _state.label = 5;
+                case 5:
+                    _state.trys.push([
+                        5,
+                        7,
+                        ,
+                        8
+                    ]);
+                    return [
+                        4,
+                        registry.close()
+                    ];
+                case 6:
+                    _state.sent();
+                    return [
+                        3,
+                        8
+                    ];
+                case 7:
+                    _ = _state.sent();
+                    return [
+                        3,
+                        8
+                    ];
+                case 8:
+                    return [
+                        7
+                    ];
+                case 9:
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+}
+/* 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/read-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/commands/read-resource.ts"],"sourcesContent":["/**\n * read-resource.ts\n *\n * Read MCP resources from the command line.\n * Supports stdio (spawned) and http (remote) servers per MCP spec.\n */\n\nimport { createServerRegistry, type ManagedClient, type ServerRegistry } from '@mcp-z/client';\nimport { type InlineConfigOptions, resolveServerConfig } from '../lib/resolve-server-config.ts';\nimport { isHttpServer } from '../types.ts';\n\nexport interface ReadResourceOptions extends InlineConfigOptions {\n  uri: string; // Resource URI (positional)\n  json?: boolean; // --json\n}\n\n/**\n * Main read-resource command implementation.\n *\n * @param opts - Read resource options from CLI flags\n *\n * @example\n * // Read a resource by URI\n * await readResourceCommand({\n *   server: 'gmail',\n *   uri: 'gmail://messages/abc123',\n * });\n */\nexport async function readResourceCommand(opts: ReadResourceOptions): Promise<void> {\n  let registry: ServerRegistry | undefined;\n  let client: ManagedClient | undefined;\n\n  try {\n    // 1. Resolve server configuration (from config file or inline options)\n    const { serverName, serverConfig, configDir } = resolveServerConfig(opts);\n\n    // 2. Create registry and connect\n    const start = Date.now();\n\n    if (isHttpServer(serverConfig)) {\n      // HTTP server - no spawning needed\n      if (!opts.json) {\n        console.log(`🔗 Connecting to ${serverName}...`);\n      }\n    } else {\n      // Stdio server - will be spawned\n      if (!opts.json) {\n        console.log(`🚀 Spawning ${serverName} server...`);\n      }\n\n      if (!serverConfig.command) {\n        throw new Error(`Stdio server ${serverName} missing required \"command\" field`);\n      }\n    }\n\n    // Create registry (spawns stdio servers, registers HTTP servers)\n    registry = createServerRegistry({ [serverName]: serverConfig }, { cwd: configDir });\n    client = await registry.connect(serverName);\n\n    if (!isHttpServer(serverConfig) && !opts.json) {\n      const elapsed = ((Date.now() - start) / 1000).toFixed(1);\n      console.log(`✓ Server ready in ${elapsed}s\\n`);\n    }\n\n    // 5. Read resource\n    if (!opts.json) {\n      console.log(`📖 Reading ${opts.uri}...`);\n    }\n\n    const resourceResponse = await client.readResource(opts.uri);\n    const resource = resourceResponse.raw();\n\n    // Success case\n    if (opts.json) {\n      // JSON output mode\n      console.log(JSON.stringify(resource, null, 2));\n    } else {\n      // Human-readable output\n      console.log('✅ Read succeeded\\n');\n\n      // Display contents\n      for (const content of resource.contents) {\n        if ('text' in content) {\n          console.log('Content:');\n          console.log(content.text);\n        } else if ('blob' in content) {\n          console.log(`Blob content (${content.mimeType || 'unknown type'}): ${content.blob.length} bytes`);\n        }\n      }\n    }\n  } catch (error) {\n    if (opts.json) {\n      console.log(JSON.stringify({ error: error instanceof Error ? error.message : String(error) }, null, 2));\n    } else {\n      console.error(`\\n❌ ${error instanceof Error ? error.message : String(error)}`);\n    }\n    throw error;\n  } finally {\n    // 7. Cleanup - registry.close() handles both client and server close\n    if (registry) {\n      try {\n        await registry.close();\n      } catch (_) {\n        // Ignore close errors\n      }\n    }\n  }\n}\n"],"names":["readResourceCommand","opts","registry","client","resolveServerConfig","serverName","serverConfig","configDir","start","elapsed","resourceResponse","resource","content","error","_","Date","now","isHttpServer","json","console","log","command","Error","createServerRegistry","cwd","connect","toFixed","uri","readResource","raw","JSON","stringify","contents","text","mimeType","blob","length","message","String","close"],"mappings":"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"}

package/dist/cjs/commands/search.d.cts

@@ -0,0 +1,31 @@
+/**
+ * search.ts
+ *
+ * Search MCP server capabilities (tools, prompts, resources) without loading full schemas.
+ * Designed for agent discovery workflows.
+ */
+export interface SearchCommandOptions {
+    config?: string;
+    servers?: string;
+    types?: string;
+    fields?: string;
+    limit?: number;
+    threshold?: number;
+    json?: boolean;
+    attach?: boolean;
+}
+/**
+ * Main search command implementation.
+ *
+ * @param query - The search query string
+ * @param opts - Search options from CLI flags
+ *
+ * @example
+ * // Search for email-related capabilities
+ * await searchCommand('send email', {});
+ *
+ * @example
+ * // Search only tools in specific servers
+ * await searchCommand('spreadsheet', { types: 'tool', servers: 'sheets,drive' });
+ */
+export declare function searchCommand(query: string, opts?: SearchCommandOptions): Promise<void>;

package/dist/cjs/commands/search.d.ts

@@ -0,0 +1,31 @@
+/**
+ * search.ts
+ *
+ * Search MCP server capabilities (tools, prompts, resources) without loading full schemas.
+ * Designed for agent discovery workflows.
+ */
+export interface SearchCommandOptions {
+    config?: string;
+    servers?: string;
+    types?: string;
+    fields?: string;
+    limit?: number;
+    threshold?: number;
+    json?: boolean;
+    attach?: boolean;
+}
+/**
+ * Main search command implementation.
+ *
+ * @param query - The search query string
+ * @param opts - Search options from CLI flags
+ *
+ * @example
+ * // Search for email-related capabilities
+ * await searchCommand('send email', {});
+ *
+ * @example
+ * // Search only tools in specific servers
+ * await searchCommand('spreadsheet', { types: 'tool', servers: 'sheets,drive' });
+ */
+export declare function searchCommand(query: string, opts?: SearchCommandOptions): Promise<void>;