@mcp-z/cli 1.0.0

package/dist/cjs/commands/search.js

@@ -0,0 +1,464 @@
+/**
+ * search.ts
+ *
+ * Search MCP server capabilities (tools, prompts, resources) without loading full schemas.
+ * Designed for agent discovery workflows.
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "searchCommand", {
+    enumerable: true,
+    get: function() {
+        return searchCommand;
+    }
+});
+var _client = require("@mcp-z/client");
+var _fs = /*#__PURE__*/ _interop_require_wildcard(require("fs"));
+var _path = /*#__PURE__*/ _interop_require_wildcard(require("path"));
+var _findconfigts = require("../lib/find-config.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 _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 _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 searchCommand(_0) {
+    return _async_to_generator(function(query) {
+        var opts, registry, _ref, _raw_mcpServers, _opts_limit, _opts_threshold, _searchOptions_servers, configPath, raw, servers, configDir, searchOptions, serverNames, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, serverName, error, err, response, _;
+        var _arguments = arguments;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    opts = _arguments.length > 1 && _arguments[1] !== void 0 ? _arguments[1] : {};
+                    _state.label = 1;
+                case 1:
+                    _state.trys.push([
+                        1,
+                        ,
+                        13,
+                        18
+                    ]);
+                    configPath = (0, _findconfigts.findConfigPath)(opts.config);
+                    raw = JSON.parse(_fs.readFileSync(configPath, 'utf8'));
+                    servers = (_ref = (_raw_mcpServers = raw.mcpServers) !== null && _raw_mcpServers !== void 0 ? _raw_mcpServers : raw.servers) !== null && _ref !== void 0 ? _ref : raw;
+                    configDir = _path.dirname(configPath);
+                    // Parse options
+                    searchOptions = {
+                        types: parseTypes(opts.types),
+                        servers: parseServers(opts.servers),
+                        searchFields: parseFields(opts.fields),
+                        limit: (_opts_limit = opts.limit) !== null && _opts_limit !== void 0 ? _opts_limit : 20,
+                        threshold: (_opts_threshold = opts.threshold) !== null && _opts_threshold !== void 0 ? _opts_threshold : 0
+                    };
+                    // Create registry (spawns stdio servers, registers HTTP servers)
+                    // In attach mode, don't spawn - just register for connection
+                    registry = (0, _client.createServerRegistry)(servers, {
+                        cwd: configDir,
+                        dialects: opts.attach ? [] : [
+                            'servers',
+                            'start'
+                        ]
+                    });
+                    // Connect to all servers (or filtered subset)
+                    serverNames = (_searchOptions_servers = searchOptions.servers) !== null && _searchOptions_servers !== void 0 ? _searchOptions_servers : Object.keys(servers || {});
+                    _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+                    _state.label = 2;
+                case 2:
+                    _state.trys.push([
+                        2,
+                        9,
+                        10,
+                        11
+                    ]);
+                    _iterator = serverNames[Symbol.iterator]();
+                    _state.label = 3;
+                case 3:
+                    if (!!(_iteratorNormalCompletion = (_step = _iterator.next()).done)) return [
+                        3,
+                        8
+                    ];
+                    serverName = _step.value;
+                    _state.label = 4;
+                case 4:
+                    _state.trys.push([
+                        4,
+                        6,
+                        ,
+                        7
+                    ]);
+                    return [
+                        4,
+                        registry.connect(serverName)
+                    ];
+                case 5:
+                    _state.sent();
+                    return [
+                        3,
+                        7
+                    ];
+                case 6:
+                    error = _state.sent();
+                    // Log connection errors but continue with other servers
+                    if (!opts.json) {
+                        console.error("⚠ Failed to connect to ".concat(serverName, ": ").concat(_instanceof(error, Error) ? error.message : String(error)));
+                    }
+                    return [
+                        3,
+                        7
+                    ];
+                case 7:
+                    _iteratorNormalCompletion = true;
+                    return [
+                        3,
+                        3
+                    ];
+                case 8:
+                    return [
+                        3,
+                        11
+                    ];
+                case 9:
+                    err = _state.sent();
+                    _didIteratorError = true;
+                    _iteratorError = err;
+                    return [
+                        3,
+                        11
+                    ];
+                case 10:
+                    try {
+                        if (!_iteratorNormalCompletion && _iterator.return != null) {
+                            _iterator.return();
+                        }
+                    } finally{
+                        if (_didIteratorError) {
+                            throw _iteratorError;
+                        }
+                    }
+                    return [
+                        7
+                    ];
+                case 11:
+                    return [
+                        4,
+                        registry.searchCapabilities(query, searchOptions)
+                    ];
+                case 12:
+                    response = _state.sent();
+                    // Output results
+                    if (opts.json) {
+                        outputJSON(response);
+                    } else {
+                        outputPretty(response);
+                    }
+                    return [
+                        3,
+                        18
+                    ];
+                case 13:
+                    if (!registry) return [
+                        3,
+                        17
+                    ];
+                    _state.label = 14;
+                case 14:
+                    _state.trys.push([
+                        14,
+                        16,
+                        ,
+                        17
+                    ]);
+                    return [
+                        4,
+                        registry.close()
+                    ];
+                case 15:
+                    _state.sent();
+                    return [
+                        3,
+                        17
+                    ];
+                case 16:
+                    _ = _state.sent();
+                    return [
+                        3,
+                        17
+                    ];
+                case 17:
+                    return [
+                        7
+                    ];
+                case 18:
+                    return [
+                        2
+                    ];
+            }
+        });
+    }).apply(this, arguments);
+}
+/**
+ * Parse comma-separated types into CapabilityType array
+ */ function parseTypes(typesStr) {
+    if (!typesStr) return undefined;
+    var validTypes = [
+        'tool',
+        'prompt',
+        'resource'
+    ];
+    var parsed = typesStr.split(',').map(function(t) {
+        return t.trim().toLowerCase();
+    });
+    var invalid = parsed.filter(function(t) {
+        return !validTypes.includes(t);
+    });
+    if (invalid.length > 0) {
+        throw new Error("Invalid types: ".concat(invalid.join(', '), ". Valid types: ").concat(validTypes.join(', ')));
+    }
+    return parsed;
+}
+/**
+ * Parse comma-separated server names
+ */ function parseServers(serversStr) {
+    if (!serversStr) return undefined;
+    return serversStr.split(',').map(function(s) {
+        return s.trim();
+    });
+}
+/**
+ * Parse comma-separated search fields
+ */ function parseFields(fieldsStr) {
+    if (!fieldsStr) return undefined;
+    var validFields = [
+        'name',
+        'description',
+        'schema',
+        'server'
+    ];
+    var parsed = fieldsStr.split(',').map(function(f) {
+        return f.trim().toLowerCase();
+    });
+    var invalid = parsed.filter(function(f) {
+        return !validFields.includes(f);
+    });
+    if (invalid.length > 0) {
+        throw new Error("Invalid fields: ".concat(invalid.join(', '), ". Valid fields: ").concat(validFields.join(', ')));
+    }
+    return parsed;
+}
+/**
+ * Output results as JSON
+ */ function outputJSON(response) {
+    console.log(JSON.stringify(response, null, 2));
+}
+/**
+ * Output results in human-readable format
+ */ function outputPretty(response) {
+    if (response.results.length === 0) {
+        console.log('No results found for "'.concat(response.query, '"'));
+        return;
+    }
+    console.log("Found ".concat(response.total, " result").concat(response.total !== 1 ? 's' : '', ' for "').concat(response.query, '"').concat(response.total > response.results.length ? " (showing ".concat(response.results.length, ")") : '', ":\n"));
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = response.results[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var result = _step.value;
+            var typeIcon = result.type === 'tool' ? '🔧' : result.type === 'prompt' ? '💬' : '📄';
+            var score = (result.score * 100).toFixed(0);
+            console.log("".concat(typeIcon, " ").concat(result.name, " [").concat(result.type, "] (").concat(score, "%)"));
+            console.log("   Server: ".concat(result.server));
+            if (result.description) {
+                var desc = result.description.length > 100 ? "".concat(result.description.slice(0, 97), "...") : result.description;
+                console.log("   ".concat(desc));
+            }
+            if (result.matchedOn.length > 0) {
+                console.log("   Matched: ".concat(result.matchedOn.join(', ')));
+            }
+            console.log('');
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+}
+/* 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/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/commands/search.ts"],"sourcesContent":["/**\n * search.ts\n *\n * Search MCP server capabilities (tools, prompts, resources) without loading full schemas.\n * Designed for agent discovery workflows.\n */\n\nimport { type CapabilityType, createServerRegistry, type SearchField, type SearchOptions, type SearchResponse, type ServerRegistry } from '@mcp-z/client';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { findConfigPath } from '../lib/find-config.ts';\n\nexport interface SearchCommandOptions {\n  config?: string;\n  servers?: string;\n  types?: string;\n  fields?: string;\n  limit?: number;\n  threshold?: number;\n  json?: boolean;\n  attach?: boolean;\n}\n\n/**\n * Main search command implementation.\n *\n * @param query - The search query string\n * @param opts - Search options from CLI flags\n *\n * @example\n * // Search for email-related capabilities\n * await searchCommand('send email', {});\n *\n * @example\n * // Search only tools in specific servers\n * await searchCommand('spreadsheet', { types: 'tool', servers: 'sheets,drive' });\n */\nexport async function searchCommand(query: string, opts: SearchCommandOptions = {}): Promise<void> {\n  let registry: ServerRegistry | undefined;\n\n  try {\n    const configPath = findConfigPath(opts.config);\n    const raw = JSON.parse(fs.readFileSync(configPath, 'utf8'));\n    const servers = raw.mcpServers ?? raw.servers ?? raw;\n    const configDir = path.dirname(configPath);\n\n    // Parse options\n    const searchOptions: SearchOptions = {\n      types: parseTypes(opts.types),\n      servers: parseServers(opts.servers),\n      searchFields: parseFields(opts.fields),\n      limit: opts.limit ?? 20,\n      threshold: opts.threshold ?? 0,\n    };\n\n    // Create registry (spawns stdio servers, registers HTTP servers)\n    // In attach mode, don't spawn - just register for connection\n    registry = createServerRegistry(servers, {\n      cwd: configDir,\n      dialects: opts.attach ? [] : ['servers', 'start'], // Empty dialects = no spawning\n    });\n\n    // Connect to all servers (or filtered subset)\n    const serverNames = searchOptions.servers ?? Object.keys(servers || {});\n\n    for (const serverName of serverNames) {\n      try {\n        await registry.connect(serverName);\n      } catch (error) {\n        // Log connection errors but continue with other servers\n        if (!opts.json) {\n          console.error(`⚠ Failed to connect to ${serverName}: ${error instanceof Error ? error.message : String(error)}`);\n        }\n      }\n    }\n\n    // Search across connected clients\n    const response = await registry.searchCapabilities(query, searchOptions);\n\n    // Output results\n    if (opts.json) {\n      outputJSON(response);\n    } else {\n      outputPretty(response);\n    }\n  } finally {\n    // Cleanup - registry.close() handles all clients and servers\n    if (registry) {\n      try {\n        await registry.close();\n      } catch (_) {\n        // Ignore close errors\n      }\n    }\n  }\n}\n\n/**\n * Parse comma-separated types into CapabilityType array\n */\nfunction parseTypes(typesStr?: string): CapabilityType[] | undefined {\n  if (!typesStr) return undefined;\n\n  const validTypes: CapabilityType[] = ['tool', 'prompt', 'resource'];\n  const parsed = typesStr.split(',').map((t) => t.trim().toLowerCase()) as CapabilityType[];\n\n  const invalid = parsed.filter((t) => !validTypes.includes(t));\n  if (invalid.length > 0) {\n    throw new Error(`Invalid types: ${invalid.join(', ')}. Valid types: ${validTypes.join(', ')}`);\n  }\n\n  return parsed;\n}\n\n/**\n * Parse comma-separated server names\n */\nfunction parseServers(serversStr?: string): string[] | undefined {\n  if (!serversStr) return undefined;\n  return serversStr.split(',').map((s) => s.trim());\n}\n\n/**\n * Parse comma-separated search fields\n */\nfunction parseFields(fieldsStr?: string): SearchField[] | undefined {\n  if (!fieldsStr) return undefined;\n\n  const validFields: SearchField[] = ['name', 'description', 'schema', 'server'];\n  const parsed = fieldsStr.split(',').map((f) => f.trim().toLowerCase()) as SearchField[];\n\n  const invalid = parsed.filter((f) => !validFields.includes(f));\n  if (invalid.length > 0) {\n    throw new Error(`Invalid fields: ${invalid.join(', ')}. Valid fields: ${validFields.join(', ')}`);\n  }\n\n  return parsed;\n}\n\n/**\n * Output results as JSON\n */\nfunction outputJSON(response: SearchResponse): void {\n  console.log(JSON.stringify(response, null, 2));\n}\n\n/**\n * Output results in human-readable format\n */\nfunction outputPretty(response: SearchResponse): void {\n  if (response.results.length === 0) {\n    console.log(`No results found for \"${response.query}\"`);\n    return;\n  }\n\n  console.log(`Found ${response.total} result${response.total !== 1 ? 's' : ''} for \"${response.query}\"${response.total > response.results.length ? ` (showing ${response.results.length})` : ''}:\\n`);\n\n  for (const result of response.results) {\n    const typeIcon = result.type === 'tool' ? '🔧' : result.type === 'prompt' ? '💬' : '📄';\n    const score = (result.score * 100).toFixed(0);\n\n    console.log(`${typeIcon} ${result.name} [${result.type}] (${score}%)`);\n    console.log(`   Server: ${result.server}`);\n\n    if (result.description) {\n      const desc = result.description.length > 100 ? `${result.description.slice(0, 97)}...` : result.description;\n      console.log(`   ${desc}`);\n    }\n\n    if (result.matchedOn.length > 0) {\n      console.log(`   Matched: ${result.matchedOn.join(', ')}`);\n    }\n\n    console.log('');\n  }\n}\n"],"names":["searchCommand","query","opts","registry","raw","searchOptions","configPath","servers","configDir","serverNames","serverName","error","response","_","findConfigPath","config","JSON","parse","fs","readFileSync","mcpServers","path","dirname","types","parseTypes","parseServers","searchFields","parseFields","fields","limit","threshold","createServerRegistry","cwd","dialects","attach","Object","keys","connect","json","console","Error","message","String","searchCapabilities","outputJSON","outputPretty","close","typesStr","undefined","validTypes","parsed","split","map","t","trim","toLowerCase","invalid","filter","includes","length","join","serversStr","s","fieldsStr","validFields","f","log","stringify","results","total","result","typeIcon","type","score","toFixed","name","server","description","desc","slice","matchedOn"],"mappings":"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"}

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

@@ -0,0 +1,49 @@
+import { type ServerRegistry } from '@mcp-z/client';
+/**
+ * Configuration options for the upCommand function
+ * @public
+ */
+export interface UpOptions {
+    /** Optional path to custom .mcp.json configuration file */
+    config?: string;
+    /** Start only stdio servers (Claude Code compatible mode) */
+    stdioOnly?: boolean;
+    /** Start only HTTP servers with start blocks (for Claude Code Desktop) */
+    httpOnly?: boolean;
+}
+/**
+ * MCP server configuration entry per MCP specification.
+ *
+ * Supports two transport types:
+ * - stdio (default if no type): spawned process with stdin/stdout
+ * - http: remote HTTP server
+ *
+ * Transport can be inferred from URL protocol:
+ * - http:// or https:// → http
+ *
+ * @see https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
+ */
+/**
+ * Start a cluster of MCP servers from a configuration file or object.
+ *
+ * @param opts - Configuration options
+ * @param opts.config - Optional path to custom .mcp.json file
+ * @returns ServerRegistry with servers map, config, connect method, and close function
+ *
+ * @example
+ * // Auto-discover .mcp.json in current directory
+ * const registry = await upCommand();
+ *
+ * @example
+ * // Load from specific config
+ * const registry = await upCommand({ config: '/path/to/.mcp.json' });
+ *
+ * @example
+ * // Use in-memory config
+ * const registry = await upCommand({
+ *   mcpServers: {
+ *     'echo-stdio': { command: 'node', args: ['test/lib/servers/echo-stdio.ts'] }
+ *   }
+ * });
+ */
+export declare function upCommand(opts?: UpOptions): Promise<ServerRegistry>;

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

@@ -0,0 +1,49 @@
+import { type ServerRegistry } from '@mcp-z/client';
+/**
+ * Configuration options for the upCommand function
+ * @public
+ */
+export interface UpOptions {
+    /** Optional path to custom .mcp.json configuration file */
+    config?: string;
+    /** Start only stdio servers (Claude Code compatible mode) */
+    stdioOnly?: boolean;
+    /** Start only HTTP servers with start blocks (for Claude Code Desktop) */
+    httpOnly?: boolean;
+}
+/**
+ * MCP server configuration entry per MCP specification.
+ *
+ * Supports two transport types:
+ * - stdio (default if no type): spawned process with stdin/stdout
+ * - http: remote HTTP server
+ *
+ * Transport can be inferred from URL protocol:
+ * - http:// or https:// → http
+ *
+ * @see https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
+ */
+/**
+ * Start a cluster of MCP servers from a configuration file or object.
+ *
+ * @param opts - Configuration options
+ * @param opts.config - Optional path to custom .mcp.json file
+ * @returns ServerRegistry with servers map, config, connect method, and close function
+ *
+ * @example
+ * // Auto-discover .mcp.json in current directory
+ * const registry = await upCommand();
+ *
+ * @example
+ * // Load from specific config
+ * const registry = await upCommand({ config: '/path/to/.mcp.json' });
+ *
+ * @example
+ * // Use in-memory config
+ * const registry = await upCommand({
+ *   mcpServers: {
+ *     'echo-stdio': { command: 'node', args: ['test/lib/servers/echo-stdio.ts'] }
+ *   }
+ * });
+ */
+export declare function upCommand(opts?: UpOptions): Promise<ServerRegistry>;