@samanhappy/mcphub 1.0.0 → 1.0.1

package/dist/cli/commands/servers.js

@@ -0,0 +1,142 @@
+import fs from 'node:fs';
+import { CliUsageError } from '../errors.js';
+import { buildClient, resolveTarget } from '../context.js';
+import { extractFlags } from '../parse-args.js';
+import { green, printJson, printLine, printTable } from '../output.js';
+export async function run(args, globals, deps = {}) {
+    const sub = args.shift();
+    const client = deps.client ?? buildClient(resolveTarget(globals));
+    switch (sub) {
+        case undefined:
+        case 'list':
+            return list(client, globals);
+        case 'get':
+            return get(client, args, globals);
+        case 'add':
+            return add(client, args, globals, deps);
+        case 'remove':
+            return remove(client, args);
+        case 'toggle':
+            return toggle(client, args);
+        case 'reload':
+            return reload(client, args);
+        default:
+            throw new CliUsageError(`Unknown servers subcommand: ${sub}`);
+    }
+}
+async function list(client, globals) {
+    const res = await client.get('/api/servers');
+    const servers = res.data ?? [];
+    if (globals.json) {
+        printJson(servers);
+        return;
+    }
+    printTable(servers.map((s) => ({
+        name: s.name,
+        status: s.status,
+        tools: s.tools?.length ?? 0,
+        owner: s.owner ?? '',
+        error: s.error ?? '',
+    })), ['name', 'status', 'tools', 'owner', 'error']);
+}
+async function get(client, args, globals) {
+    const name = args[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers get <name>');
+    const res = await client.get(`/api/servers/${encodeURIComponent(name)}`);
+    if (globals.json) {
+        printJson(res.data);
+        return;
+    }
+    printLine(JSON.stringify(res.data, null, 2));
+}
+async function add(client, args, globals, deps) {
+    const { positional, flags } = extractFlags(args, {
+        valued: ['--from-file', '--type', '--command', '--url', '--description'],
+        boolean: ['--enabled', '--disabled'],
+    });
+    const name = positional[0];
+    if (!name) {
+        throw new CliUsageError('Usage: mcphub servers add <name> --from-file <path>\n' +
+            '   or  mcphub servers add <name> --type <stdio|sse|streamable-http|openapi> [--command ...] [--arg ...] [--env K=V ...]');
+    }
+    let config;
+    if (flags['--from-file']) {
+        const path = flags['--from-file'];
+        const raw = (deps.fs ?? fs).readFileSync(path, 'utf8');
+        config = JSON.parse(raw);
+    }
+    else {
+        const argArgs = collectRepeated(args, '--arg');
+        const envEntries = collectRepeated(args, '--env').map((kv) => {
+            const idx = kv.indexOf('=');
+            if (idx < 0)
+                throw new CliUsageError(`--env expects KEY=VALUE, got: ${kv}`);
+            return [kv.slice(0, idx), kv.slice(idx + 1)];
+        });
+        config = {
+            type: flags['--type'] || 'stdio',
+            description: flags['--description'],
+            command: flags['--command'],
+            args: argArgs.length > 0 ? argArgs : undefined,
+            env: envEntries.length > 0 ? Object.fromEntries(envEntries) : undefined,
+            url: flags['--url'],
+            enabled: flags['--disabled'] ? false : true,
+        };
+    }
+    const res = await client.post('/api/servers', { name, config });
+    if (globals.json) {
+        printJson(res);
+        return;
+    }
+    printLine(green(`Added server "${name}".`));
+}
+async function remove(client, args) {
+    const name = args[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers remove <name>');
+    await client.delete(`/api/servers/${encodeURIComponent(name)}`);
+    printLine(green(`Removed server "${name}".`));
+}
+async function toggle(client, args) {
+    const { positional, flags } = extractFlags(args, { boolean: ['--on', '--off'] });
+    const name = positional[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers toggle <name> [--on|--off]');
+    const body = {};
+    if (flags['--on'])
+        body.enabled = true;
+    if (flags['--off'])
+        body.enabled = false;
+    await client.post(`/api/servers/${encodeURIComponent(name)}/toggle`, body);
+    printLine(green(`Toggled server "${name}".`));
+}
+async function reload(client, args) {
+    const name = args[0];
+    if (!name)
+        throw new CliUsageError('Usage: mcphub servers reload <name>');
+    await client.post(`/api/servers/${encodeURIComponent(name)}/reload`, {});
+    printLine(green(`Reloaded server "${name}".`));
+}
+// Helper: pull every occurrence of `--flag <value>` out of argv. extractFlags
+// only captures the last occurrence, so repeated flags need this scan. Values
+// may legitimately start with `--` (e.g. `--arg --version` for a wrapped CLI);
+// we consume them unconditionally and skip the next index so we don't re-scan
+// the value as another flag boundary.
+function collectRepeated(argv, flag) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        if (argv[i] === flag) {
+            const v = argv[i + 1];
+            if (v !== undefined) {
+                out.push(v);
+                i++;
+            }
+        }
+        else if (argv[i].startsWith(`${flag}=`)) {
+            out.push(argv[i].slice(flag.length + 1));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=servers.js.map

package/dist/cli/commands/servers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"servers.js","sourceRoot":"","sources":["../../../src/cli/commands/servers.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/tools.js

@@ -0,0 +1,162 @@
+import { CliUsageError } from '../errors.js';
+import { buildClient, resolveTarget } from '../context.js';
+import { extractFlags } from '../parse-args.js';
+import { bold, dim, printJson, printLine, printTable } from '../output.js';
+// `tools` is the agent-friendly index for `call`: it answers "what can I call,
+// what params does it take, where does it live" in one place, without making
+// callers post-process `servers list` responses.
+export async function run(args, globals, deps = {}) {
+    const sub = args.shift();
+    const client = deps.client ?? buildClient(resolveTarget(globals));
+    switch (sub) {
+        case undefined:
+        case 'list':
+            return list(client, args, globals);
+        case 'get':
+        case 'schema':
+            return get(client, args, globals);
+        default:
+            throw new CliUsageError(`Unknown tools subcommand: ${sub}`);
+    }
+}
+async function fetchFlatTools(client) {
+    const res = await client.get('/api/servers');
+    const servers = res.data ?? [];
+    const out = [];
+    for (const s of servers) {
+        for (const t of (s.tools ?? [])) {
+            out.push({
+                server: s.name,
+                serverStatus: s.status,
+                name: t.name,
+                description: t.description,
+                enabled: t.enabled,
+                inputSchema: t.inputSchema,
+            });
+        }
+    }
+    return out;
+}
+async function list(client, args, globals) {
+    const { flags } = extractFlags(args, {
+        valued: ['--server'],
+        boolean: ['--schema', '--enabled-only'],
+    });
+    let tools = await fetchFlatTools(client);
+    if (flags['--server']) {
+        const wanted = String(flags['--server']);
+        tools = tools.filter((t) => t.server === wanted);
+    }
+    if (flags['--enabled-only']) {
+        tools = tools.filter((t) => t.enabled !== false);
+    }
+    if (globals.json) {
+        if (!flags['--schema']) {
+            // Drop inputSchema by default to keep the JSON small; callers can opt in.
+            printJson(tools.map(({ inputSchema: _omit, ...rest }) => rest));
+        }
+        else {
+            printJson(tools);
+        }
+        return;
+    }
+    if (tools.length === 0) {
+        printLine(dim('(no tools)'));
+        return;
+    }
+    printTable(tools.map((t) => ({
+        server: t.server,
+        tool: t.name,
+        enabled: t.enabled === false ? 'no' : 'yes',
+        description: truncate(t.description ?? '', 60),
+    })), ['server', 'tool', 'enabled', 'description']);
+    printLine(dim(`\nUse \`mcphub tools get <tool> [--server <name>]\` to see input schema and required params.`));
+}
+async function get(client, args, globals) {
+    const { positional, flags } = extractFlags(args, { valued: ['--server'] });
+    const name = positional[0];
+    if (!name) {
+        throw new CliUsageError('Usage: mcphub tools get <tool-name> [--server <server-name>]');
+    }
+    const wantedServer = flags['--server'];
+    const matches = (await fetchFlatTools(client)).filter((t) => t.name === name && (!wantedServer || t.server === wantedServer));
+    if (matches.length === 0) {
+        throw new CliUsageError(wantedServer
+            ? `Tool "${name}" not found on server "${wantedServer}". Run \`mcphub tools list\` to see what's available.`
+            : `Tool "${name}" not found. Run \`mcphub tools list\` to see what's available.`);
+    }
+    if (matches.length > 1 && !wantedServer) {
+        const hosts = matches.map((m) => m.server).join(', ');
+        throw new CliUsageError(`Tool "${name}" exists on multiple servers (${hosts}). Pass --server <name> to pick one.`);
+    }
+    const tool = matches[0];
+    if (globals.json) {
+        printJson(tool);
+        return;
+    }
+    const schema = tool.inputSchema;
+    const required = new Set(schema?.required ?? []);
+    const props = schema?.properties ?? {};
+    printLine(`${bold('Server:')}      ${tool.server} (${tool.serverStatus})`);
+    printLine(`${bold('Tool:')}        ${tool.name}`);
+    if (tool.description) {
+        printLine(`${bold('Description:')} ${tool.description}`);
+    }
+    if (tool.enabled === false) {
+        printLine(dim('(disabled — calls will fail until re-enabled)'));
+    }
+    printLine('');
+    if (Object.keys(props).length === 0) {
+        printLine(dim('No documented parameters.'));
+    }
+    else {
+        printLine(bold('Parameters:'));
+        const rows = Object.entries(props).map(([key, p]) => ({
+            param: key,
+            type: typeof p === 'object' && p ? p.type ?? '' : '',
+            required: required.has(key) ? 'yes' : 'no',
+            description: truncate(typeof p === 'object' && p ? p.description ?? '' : '', 60),
+        }));
+        printTable(rows, ['param', 'type', 'required', 'description']);
+    }
+    printLine('');
+    printLine(bold('Input schema (JSON):'));
+    printLine(JSON.stringify(tool.inputSchema ?? {}, null, 2));
+    printLine('');
+    printLine(bold('Example:'));
+    const example = buildExample(tool, required, props);
+    printLine(`  ${example}`);
+}
+function buildExample(tool, required, props) {
+    const sample = (type) => {
+        switch (type) {
+            case 'number':
+            case 'integer':
+                return '0';
+            case 'boolean':
+                return 'true';
+            case 'array':
+                return '[]';
+            case 'object':
+                return '{}';
+            default:
+                return '<value>';
+        }
+    };
+    const parts = ['mcphub', 'call', tool.name];
+    // Show required params first, with a hint at the type. Optional params are
+    // intentionally omitted so the example is the minimum-viable call.
+    const reqKeys = Array.from(required);
+    for (const key of reqKeys) {
+        const p = props[key];
+        parts.push(`${key}=${sample(typeof p === 'object' && p ? p.type : undefined)}`);
+    }
+    parts.push(`--server`, tool.server);
+    return parts.join(' ');
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + '…';
+}
+//# sourceMappingURL=tools.js.map

package/dist/cli/commands/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/cli/commands/tools.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.js

@@ -0,0 +1,44 @@
+import { ApiClient } from './http.js';
+import { CliUsageError } from './errors.js';
+import { getProfile, loadCredentials, } from './profile.js';
+// Resolve where requests should go and what token to use, in this order:
+// 1. CLI flags (--url / --token / --bearer)
+// 2. Environment variables (MCPHUB_URL / MCPHUB_TOKEN / MCPHUB_TOKEN_KIND)
+// 3. Active profile in credentials.json (--profile <name> or current)
+// Commands that only need a URL (e.g. discover) call resolveTargetForPublic()
+// instead, which doesn't require a token.
+export function resolveTarget(globals, creds) {
+    const credentials = creds ?? loadCredentials();
+    const profile = getProfile(credentials, globals.profile);
+    const baseUrl = globals.url ?? process.env.MCPHUB_URL ?? profile?.url;
+    if (!baseUrl) {
+        throw new CliUsageError('No mcphub URL configured. Use --url <url>, MCPHUB_URL env, or run `mcphub login`.');
+    }
+    const tokenKind = (globals.bearer ? 'bearer' : undefined) ??
+        process.env.MCPHUB_TOKEN_KIND ??
+        profile?.tokenKind ??
+        'jwt';
+    const token = globals.token ?? process.env.MCPHUB_TOKEN ?? profile?.token;
+    if (!token) {
+        throw new CliUsageError('Not logged in. Use --token <token>, MCPHUB_TOKEN env, or run `mcphub login`.');
+    }
+    return { baseUrl, token, tokenKind, profileName: globals.profile ?? credentials.current };
+}
+export function resolveTargetForPublic(globals, remote, creds) {
+    const credentials = creds ?? loadCredentials();
+    const profile = getProfile(credentials, globals.profile);
+    const baseUrl = remote ?? globals.url ?? process.env.MCPHUB_URL ?? profile?.url;
+    if (!baseUrl) {
+        throw new CliUsageError('No mcphub URL configured. Use --remote <url>, --url <url>, MCPHUB_URL env, or run `mcphub login`.');
+    }
+    return { baseUrl };
+}
+export function buildClient(target, fetchImpl) {
+    return new ApiClient({
+        baseUrl: target.baseUrl,
+        token: target.token,
+        tokenKind: target.tokenKind,
+        fetchImpl,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAa,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAEL,UAAU,EACV,eAAe,GAEhB,MAAM,cAAc,CAAC;AAkBtB,yEAAyE;AACzE,4CAA4C;AAC5C,2EAA2E;AAC3E,sEAAsE;AACtE,8EAA8E;AAC9E,0CAA0C;AAE1C,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,KAAmB;IACrE,MAAM,WAAW,GAAG,KAAK,IAAI,eAAe,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAwB,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,GAAG,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,mFAAmF,CACpF,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GACb,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,iBAA2C;QACxD,OAAO,EAAE,SAAS;QAClB,KAAK,CAAC;IACR,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,KAAK,CAAC;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,aAAa,CACrB,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAoB,EACpB,MAAe,EACf,KAAmB;IAEnB,MAAM,WAAW,GAAG,KAAK,IAAI,eAAe,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,GAAG,CAAC;IAChF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CACrB,mGAAmG,CACpG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAsB,EAAE,SAAwB;IAC1E,OAAO,IAAI,SAAS,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/errors.js

@@ -0,0 +1,19 @@
+// Errors thrown by the CLI layer. Top-level handler in main.ts inspects the
+// constructor (or `requiresLogin` flag) to choose an exit code and decide
+// whether to print remediation hints.
+export class CliUsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CliUsageError';
+    }
+}
+export class CliApiError extends Error {
+    constructor(init) {
+        super(init.message);
+        this.name = 'CliApiError';
+        this.status = init.status;
+        this.body = init.body;
+        this.requiresLogin = init.requiresLogin ?? init.status === 401;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,sCAAsC;AAEtC,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AASD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAKpC,YAAY,IAAqB;QAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC;IACjE,CAAC;CACF"}

package/dist/cli/help.js

@@ -0,0 +1,157 @@
+import { printLine } from './output.js';
+const TOP_LEVEL_HELP = `mcphub — official CLI for the mcphub server
+
+Usage:
+  mcphub                           start the mcphub server (legacy, no-arg form)
+  mcphub <command> [options]       run a CLI command
+
+Commands:
+  login                            interactively log in to a mcphub instance
+  logout                           clear the cached token for the active profile
+  config                           manage local profiles and credentials
+  servers                          list/get/add/remove/toggle/reload MCP servers
+  groups                           manage server groups
+  keys                             manage bearer keys
+  tools                            list MCP tools and inspect their input schema
+  call                             call an MCP tool via /mcp/$smart or /mcp/<server|group>
+  export                           export the running hub's mcp_settings.json
+  discover                         browse a remote hub's public marketplace
+  install                          install a server from a remote marketplace
+  help [command]                   show help for a command
+
+Global options:
+  --url <url>                      override the active profile's base URL
+  --token <token>                  override the active profile's token
+  --bearer                         treat --token as a bearer key (default: JWT)
+  --profile <name>                 use a specific saved profile
+  --json                           print JSON output instead of human-friendly
+  --debug                          print stack traces on error
+
+Environment:
+  MCPHUB_URL, MCPHUB_TOKEN, MCPHUB_TOKEN_KIND
+  XDG_CONFIG_HOME, XDG_DATA_HOME, NO_COLOR
+`;
+const COMMAND_HELP = {
+    login: `mcphub login [--url <url>] [--username <name>] [--password <pwd>]
+
+Log in to a mcphub instance and cache a JWT in the active profile.
+Prompts for missing values. The token is written to credentials.json
+with 0600 permissions.`,
+    logout: `mcphub logout
+
+Clear the token from the active profile (URL and username are preserved).`,
+    config: `mcphub config <subcommand>
+
+Subcommands:
+  show                             print the active profile (token masked)
+  list                             list all saved profiles
+  use <name>                       switch the active profile
+  set-url <url>                    set the URL of a profile (--profile to target)
+  set-token <token> [--bearer]     set the token of a profile manually
+  remove <name>                    delete a saved profile`,
+    servers: `mcphub servers <subcommand>
+
+Subcommands:
+  list                             list all servers
+  get <name>                       show one server's config
+  add <name> --from-file <path>    add a server from a JSON file
+  add <name> --type stdio --command <cmd> [--arg <a> ...] [--env K=V ...]
+  remove <name>                    delete a server
+  toggle <name> [--on|--off]       enable/disable a server
+  reload <name>                    reconnect a server`,
+    groups: `mcphub groups <subcommand>
+
+Subcommands:
+  list                             list groups
+  get <id|name>                    show one group
+  add <name> [--description <d>]   create a group
+  remove <id|name>                 delete a group
+  add-server <group> <server>      add a server to a group
+  remove-server <group> <server>   remove a server from a group`,
+    keys: `mcphub keys <subcommand>
+
+Subcommands:
+  list                             list bearer keys
+  create --name <n> [--access-type all|groups|servers|custom]
+         [--groups a,b] [--servers x,y]
+  delete <id>                      delete a key`,
+    tools: `mcphub tools <subcommand>
+
+The agent-friendly index for \`call\`. Use it to discover what's available
+and what params each tool wants without hand-parsing \`servers list\` JSON.
+
+Subcommands:
+  list [--server <name>] [--enabled-only] [--schema]
+                                   list tools across all (or one) servers
+  get <tool> [--server <name>]     show one tool's description, parameters,
+                                   input schema, and a sample \`call\` command
+  schema <tool> [--server <name>]  alias for \`get\``,
+    call: `mcphub call <tool> [k=v ...] [--server <s>|--group <g>|--smart] [--params-json <json>]
+
+Discover what to pass via:
+  mcphub tools list                   # all tools
+  mcphub tools get <tool>             # required params + sample command
+
+Argument parsing:
+  key=value                        string by default
+  key=42 / key=true / key=null     auto-coerced to number/boolean/null
+  key=@path                        load JSON from file
+  --params-json '{"a":1}'          override the entire params object
+
+Routing precedence: --smart > --server > --group > default ($smart). All
+three resolve to /mcp/<slug>; --server is the natural pair for
+\`tools list\` output.`,
+    export: `mcphub export [--out <path>]
+
+Download the running hub's mcp_settings.json. Default: stdout (pretty JSON).`,
+    discover: `mcphub discover [subcommand] [--remote <url>] [--search <q>]
+                          [--category <c>] [--tag <t>] [--limit <n>]
+
+Browse the public marketplace API (requires the hub to have
+systemConfig.discovery.enabled=true).
+
+Subcommands:
+  (default)                        list market servers
+  info <name>                      show a single server
+  categories                       list categories
+  tags                             list tags`,
+    install: `mcphub install <name> [--remote <url>] [--type npm|docker|uvx|pip|binary]
+                          [--to hub|file|stdout] [--out <path>]
+                          [--env K=V ...] [--dry-run] [--yes] [--force]
+
+Install a server from a remote hub's marketplace.
+
+--to hub      POST /api/servers on the active profile's hub (default)
+--to file     merge mcpServers into a Claude Desktop / OpenClaw-style JSON
+--to stdout   print the mcpServers snippet (same as --dry-run)
+`,
+};
+export function printHelp(command) {
+    if (!command) {
+        printLine(TOP_LEVEL_HELP);
+        return;
+    }
+    const help = COMMAND_HELP[command];
+    if (!help) {
+        printLine(`No help available for "${command}".`);
+        printLine('');
+        printLine(TOP_LEVEL_HELP);
+        return;
+    }
+    printLine(help);
+}
+export function printVersion() {
+    // The version is read lazily so tests don't have to mock the package.json
+    // path. We import via createRequire to keep this ESM-safe.
+    import('node:module').then(({ createRequire }) => {
+        try {
+            const require = createRequire(import.meta.url);
+            const pkg = require('../../package.json');
+            printLine(pkg.version ?? 'unknown');
+        }
+        catch {
+            printLine('unknown');
+        }
+    });
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BtB,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE;;;;uBAIc;IAErB,MAAM,EAAE;;0EAEgE;IAExE,MAAM,EAAE;;;;;;;;0DAQgD;IAExD,OAAO,EAAE;;;;;;;;;sDAS2C;IAEpD,MAAM,EAAE;;;;;;;;gEAQsD;IAE9D,IAAI,EAAE;;;;;;gDAMwC;IAE9C,KAAK,EAAE;;;;;;;;;;qDAU4C;IAEnD,IAAI,EAAE;;;;;;;;;;;;;;uBAce;IAErB,MAAM,EAAE;;6EAEmE;IAE3E,QAAQ,EAAE;;;;;;;;;;6CAUiC;IAE3C,OAAO,EAAE;;;;;;;;;CASV;CACA,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,SAAS,CAAC,cAAc,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,SAAS,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;QACjD,SAAS,CAAC,EAAE,CAAC,CAAC;QACd,SAAS,CAAC,cAAc,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,0EAA0E;IAC1E,2DAA2D;IAC3D,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE;QAC/C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;YAC1C,SAAS,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/http.js

@@ -0,0 +1,93 @@
+import { CliApiError } from './errors.js';
+// Thin fetch wrapper. Auth injection is determined by tokenKind so a single
+// client can target dashboard API (JWT via x-auth-token) or scoped bearer key
+// (Authorization: Bearer ...) routes. Non-2xx → CliApiError with parsed body.
+export class ApiClient {
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.token = opts.token;
+        this.tokenKind = opts.tokenKind ?? 'jwt';
+        this.fetchImpl = opts.fetchImpl ?? globalThis.fetch;
+    }
+    buildHeaders(extra) {
+        const headers = {
+            Accept: 'application/json',
+            ...(extra ?? {}),
+        };
+        if (this.token) {
+            if (this.tokenKind === 'bearer') {
+                headers.Authorization = `Bearer ${this.token}`;
+            }
+            else {
+                headers['x-auth-token'] = this.token;
+            }
+        }
+        return headers;
+    }
+    async request(method, path, body, init) {
+        const url = path.startsWith('http') ? path : `${this.baseUrl}${path.startsWith('/') ? '' : '/'}${path}`;
+        const headers = this.buildHeaders(init?.headers);
+        let payload;
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            payload = JSON.stringify(body);
+        }
+        const res = await this.fetchImpl(url, {
+            ...init,
+            method,
+            headers,
+            body: payload,
+        });
+        const text = await res.text();
+        let parsed = undefined;
+        if (text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+        }
+        if (!res.ok) {
+            const message = extractMessage(parsed) ?? `${method} ${path} failed with ${res.status}`;
+            throw new CliApiError({
+                status: res.status,
+                message,
+                body: parsed,
+                requiresLogin: res.status === 401,
+            });
+        }
+        return parsed;
+    }
+    get(path, init) {
+        return this.request('GET', path, undefined, init);
+    }
+    post(path, body, init) {
+        return this.request('POST', path, body, init);
+    }
+    put(path, body, init) {
+        return this.request('PUT', path, body, init);
+    }
+    delete(path, init) {
+        return this.request('DELETE', path, undefined, init);
+    }
+    // POST to /mcp/:group? with a JSON-RPC body. `group` may be a literal group
+    // name, '$smart' for smart routing, or null for the global endpoint.
+    async mcpCall(group, payload) {
+        const suffix = group ? `/${encodeURIComponent(group)}` : '';
+        return this.request('POST', `/mcp${suffix}`, payload);
+    }
+}
+function extractMessage(body) {
+    if (body && typeof body === 'object') {
+        const obj = body;
+        if (typeof obj.message === 'string')
+            return obj.message;
+        if (typeof obj.error === 'string')
+            return obj.error;
+    }
+    if (typeof body === 'string' && body.trim())
+        return body;
+    return undefined;
+}
+//# sourceMappingURL=http.js.map