@mcp-z/cli 1.0.0

package/dist/cjs/types.d.ts

@@ -0,0 +1,21 @@
+export interface MCPConfiguration {
+    mcpServers: Record<string, ServerConfig>;
+}
+export interface ServerConfigStdio {
+    type?: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface ServerConfigHttp {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+    start?: ServerConfigStdio;
+}
+export type ServerConfig = ServerConfigStdio | ServerConfigHttp;
+export declare function isHttpServer(config: ServerConfig): config is ServerConfigHttp;
+export declare function isStdioServer(config: ServerConfig): config is ServerConfigStdio;
+export declare function hasStartBlock(config: ServerConfig): config is ServerConfigHttp & {
+    start: ServerConfigStdio;
+};

package/dist/cjs/types.js

@@ -0,0 +1,32 @@
+// Type definitions for MCP config files
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get hasStartBlock () {
+        return hasStartBlock;
+    },
+    get isHttpServer () {
+        return isHttpServer;
+    },
+    get isStdioServer () {
+        return isStdioServer;
+    }
+});
+function isHttpServer(config) {
+    return config.type === 'http';
+}
+function isStdioServer(config) {
+    return !isHttpServer(config);
+}
+function hasStartBlock(config) {
+    return isHttpServer(config) && config.start !== undefined;
+}
+/* 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/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/types.ts"],"sourcesContent":["// Type definitions for MCP config files\n\nexport interface MCPConfiguration {\n  mcpServers: Record<string, ServerConfig>;\n}\n\n// Stdio server: spawns with stdio transport\nexport interface ServerConfigStdio {\n  type?: 'stdio'; // Optional: absence means stdio\n  command: string;\n  args?: string[]; // OPTIONAL per .mcp.json standard\n  env?: Record<string, string>;\n}\n\n// HTTP server: connects to URL, optionally spawns the server locally\nexport interface ServerConfigHttp {\n  type: 'http';\n  url: string;\n  headers?: Record<string, string>;\n  start?: ServerConfigStdio; // Extension: reuse stdio config for spawning HTTP servers\n}\n\nexport type ServerConfig = ServerConfigStdio | ServerConfigHttp;\n\n// Type guards\nexport function isHttpServer(config: ServerConfig): config is ServerConfigHttp {\n  return config.type === 'http';\n}\n\nexport function isStdioServer(config: ServerConfig): config is ServerConfigStdio {\n  return !isHttpServer(config);\n}\n\nexport function hasStartBlock(config: ServerConfig): config is ServerConfigHttp & { start: ServerConfigStdio } {\n  return isHttpServer(config) && config.start !== undefined;\n}\n"],"names":["hasStartBlock","isHttpServer","isStdioServer","config","type","start","undefined"],"mappings":"AAAA,wCAAwC;;;;;;;;;;;;QAiCxBA;eAAAA;;QARAC;eAAAA;;QAIAC;eAAAA;;;AAJT,SAASD,aAAaE,MAAoB;IAC/C,OAAOA,OAAOC,IAAI,KAAK;AACzB;AAEO,SAASF,cAAcC,MAAoB;IAChD,OAAO,CAACF,aAAaE;AACvB;AAEO,SAASH,cAAcG,MAAoB;IAChD,OAAOF,aAAaE,WAAWA,OAAOE,KAAK,KAAKC;AAClD"}

package/dist/esm/cli.d.ts

@@ -0,0 +1 @@
+export default function cli(argv: string[], programName: string): void;

package/dist/esm/cli.js

@@ -0,0 +1,129 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import moduleRoot from 'module-root-sync';
+import * as path from 'path';
+import * as url from 'url';
+import { callToolCommand } from './commands/call-tool.js';
+import { getPromptCommand } from './commands/get-prompt.js';
+import { inspectCommand } from './commands/inspect.js';
+import { createManifestCommand } from './commands/manifest/index.js';
+import { readResourceCommand } from './commands/read-resource.js';
+import { searchCommand } from './commands/search.js';
+import { upCommand } from './commands/up.js';
+const pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot(url.fileURLToPath(import.meta.url)), 'package.json'), 'utf-8'));
+export default function cli(argv, programName) {
+    const program = new 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(async (options)=>{
+        try {
+            const clusterResult = await upCommand({
+                config: options.config,
+                stdioOnly: options.stdioOnly,
+                httpOnly: options.httpOnly
+            });
+            // If httpOnly mode and no servers were spawned, exit immediately
+            if (options.httpOnly && clusterResult.servers.size === 0) process.exit(0);
+            const shutdown = async (sig)=>{
+                console.log('Shutting down (signal=', sig, ')');
+                if (clusterResult && typeof clusterResult.close === 'function') {
+                    try {
+                        await clusterResult.close(sig === 'SIGTERM' ? 'SIGTERM' : 'SIGINT', {
+                            timeoutMs: 1000
+                        });
+                    } catch (_) {
+                    /* ignore */ }
+                }
+                process.exit(0);
+            };
+            // Signal handlers trigger async shutdown then exit
+            process.on('SIGINT', ()=>{
+                shutdown('SIGINT').catch(()=>process.exit(1));
+            });
+            process.on('SIGTERM', ()=>{
+                shutdown('SIGTERM').catch(()=>process.exit(1));
+            });
+            // Keep process alive - wait for signal
+            await new Promise(()=>{});
+        } catch (error) {
+            console.error(`\n❌ ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    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(async (options)=>{
+        try {
+            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
+            });
+        } catch (error) {
+            console.error(`\n❌ ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    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(async (server, tool, args, options)=>{
+        // 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
+        const opts = {
+            server,
+            tool,
+            args,
+            ...options,
+            run: options.run,
+            serverConfig: options.server
+        };
+        await callToolCommand(opts);
+    });
+    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(async (server, uri, options)=>{
+        const opts = {
+            server,
+            uri,
+            ...options,
+            run: options.run,
+            serverConfig: options.server
+        };
+        await readResourceCommand(opts);
+    });
+    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(async (server, name, args, options)=>{
+        const opts = {
+            server,
+            name,
+            args: args || '{}',
+            ...options,
+            run: options.run,
+            serverConfig: options.server
+        };
+        await getPromptCommand(opts);
+    });
+    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(async (query, options)=>{
+        try {
+            await searchCommand(query, options);
+        } catch (error) {
+            console.error(`\n❌ ${error instanceof Error ? error.message : String(error)}`);
+            process.exit(1);
+        }
+    });
+    // Add config command
+    program.addCommand(createManifestCommand());
+    program.parse([
+        'node',
+        'cli',
+        ...argv
+    ]);
+}
+// Entry point: run CLI when executed directly (not imported)
+import { fileURLToPath } from 'url';
+if (import.meta.url.startsWith('file:')) {
+    const modulePath = fileURLToPath(import.meta.url);
+    if (process.argv[1] === modulePath || process.argv[1] === modulePath.replace(/\.ts$/, '.js')) {
+        cli(process.argv.slice(2), 'mcp-z');
+    }
+}

package/dist/esm/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":["Command","fs","moduleRoot","path","url","callToolCommand","getPromptCommand","inspectCommand","createManifestCommand","readResourceCommand","searchCommand","upCommand","pkg","JSON","parse","readFileSync","join","fileURLToPath","cli","argv","programName","program","name","description","version","command","option","action","options","clusterResult","config","stdioOnly","httpOnly","servers","size","process","exit","shutdown","sig","console","log","close","timeoutMs","_","on","catch","Promise","error","Error","message","String","tools","resources","prompts","health","json","verbose","attach","server","tool","args","opts","run","serverConfig","uri","Number","parseInt","parseFloat","query","addCommand","startsWith","modulePath","replace","slice"],"mappings":"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"}

package/dist/esm/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>;

package/dist/esm/commands/call-tool.js

@@ -0,0 +1,151 @@
+/**
+ * call-tool.ts
+ *
+ * Execute MCP tools from the command line.
+ * Supports stdio (spawned) and http (remote) servers per MCP spec.
+ */ import { createServerRegistry, ToolResponseError } from '@mcp-z/client';
+import { resolveServerConfig } from '../lib/resolve-server-config.js';
+import { isHttpServer } from '../types.js';
+/**
+ * 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 async function callToolCommand(opts) {
+    let registry;
+    let client;
+    try {
+        // 1. Resolve server configuration (from config file or inline options)
+        const { serverName, serverConfig, configDir } = resolveServerConfig(opts);
+        // 2. Create registry and connect
+        const start = Date.now();
+        if (isHttpServer(serverConfig)) {
+            // HTTP server - no spawning needed
+            if (!opts.json) {
+                console.log(`🔗 Connecting to ${serverName}...`);
+            }
+        } else {
+            // Stdio server - will be spawned
+            if (!opts.json) {
+                console.log(`🚀 Spawning ${serverName} server...`);
+            }
+            if (!serverConfig.command) {
+                throw new Error(`Stdio server ${serverName} missing required "command" field`);
+            }
+        }
+        // Create registry (spawns stdio servers, registers HTTP servers)
+        registry = createServerRegistry({
+            [serverName]: serverConfig
+        }, {
+            cwd: configDir
+        });
+        client = await registry.connect(serverName);
+        if (!isHttpServer(serverConfig) && !opts.json) {
+            const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+            console.log(`✓ Server ready in ${elapsed}s\n`);
+        }
+        // 5. Parse tool arguments
+        let toolArgs;
+        try {
+            const parsed = JSON.parse(opts.args);
+            if (typeof parsed !== 'object' || parsed === null) {
+                throw new Error('Arguments must be a JSON object');
+            }
+            toolArgs = parsed;
+        } catch (error) {
+            throw new Error(`Failed to parse tool arguments as JSON: ${error instanceof Error ? error.message : String(error)}\n\nProvided args: ${opts.args}`);
+        }
+        // 6. Execute tool
+        if (!opts.json) {
+            console.log(`🔧 Calling ${opts.tool}...`);
+        }
+        let response;
+        try {
+            response = await client.callTool(opts.tool, toolArgs);
+        } catch (error) {
+            handleToolError(error, opts);
+            throw error;
+        }
+        const parsedResult = parseToolResult(response);
+        if (parsedResult !== undefined) {
+            // Success case
+            if (opts.json) {
+                // JSON output mode
+                console.log(JSON.stringify(parsedResult, null, 2));
+            } else {
+                // Human-readable output
+                console.log(`✅ ${opts.tool} succeeded\n`);
+                console.log('Result:');
+                if (typeof parsedResult === 'string') {
+                    console.log(parsedResult);
+                } else {
+                    console.log(JSON.stringify(parsedResult, null, 2));
+                }
+            }
+        }
+    } catch (error) {
+        if (opts.json) {
+            console.log(JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+            }, null, 2));
+        } else {
+            console.error(`\n❌ ${error instanceof Error ? error.message : String(error)}`);
+        }
+        throw error;
+    } finally{
+        // 8. Cleanup - registry.close() handles both client and server close
+        if (registry) {
+            try {
+                await registry.close();
+            } catch (_) {
+            // Ignore close errors
+            }
+        }
+    }
+}
+function handleToolError(error, opts) {
+    if (!(error instanceof ToolResponseError)) {
+        return;
+    }
+    const errorText = extractToolErrorText(error) || error.message;
+    if (opts.json) {
+        console.log(JSON.stringify({
+            error: errorText
+        }, null, 2));
+    } else {
+        console.log(`❌ ${opts.tool} failed\n`);
+        console.log(`Error: ${errorText}`);
+    }
+}
+function extractToolErrorText(error) {
+    const content = Array.isArray(error.response.content) ? error.response.content : [];
+    const first = content[0];
+    if ((first === null || first === void 0 ? void 0 : first.type) === 'text' && typeof first.text === 'string') {
+        return first.text;
+    }
+    return undefined;
+}
+function parseToolResult(response) {
+    try {
+        return response.json();
+    } catch (error) {
+        if (error instanceof ToolResponseError) {
+            if ('isError' in error.response && error.response.isError) {
+                throw error;
+            }
+            try {
+                return response.text();
+            } catch  {
+                return undefined;
+            }
+        }
+        throw error;
+    }
+}

package/dist/esm/commands/call-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/commands/call-tool.ts"],"sourcesContent":["/**\n * call-tool.ts\n *\n * Execute MCP tools from the command line.\n * Supports stdio (spawned) and http (remote) servers per MCP spec.\n */\n\nimport { createServerRegistry, type ManagedClient, type ServerRegistry, type ToolArguments, ToolResponseError, type ToolResponseWrapper } from '@mcp-z/client';\nimport { type InlineConfigOptions, resolveServerConfig } from '../lib/resolve-server-config.ts';\nimport { isHttpServer } from '../types.ts';\n\nexport interface CallToolOptions extends InlineConfigOptions {\n  tool: string; // Tool name (positional)\n  args: string; // JSON args (positional)\n  json?: boolean; // --json\n}\n\n/**\n * Main call-tool command implementation.\n *\n * @param opts - Call tool options from CLI flags\n *\n * @example\n * // Call a tool with JSON args\n * await callToolCommand({\n *   server: 'echo',\n *   tool: 'echo',\n *   args: '{\"message\": \"hello\"}',\n * });\n */\nexport async function callToolCommand(opts: CallToolOptions): 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. Parse tool arguments\n    let toolArgs: ToolArguments;\n    try {\n      const parsed = JSON.parse(opts.args);\n      if (typeof parsed !== 'object' || parsed === null) {\n        throw new Error('Arguments must be a JSON object');\n      }\n      toolArgs = parsed;\n    } catch (error) {\n      throw new Error(`Failed to parse tool arguments as JSON: ${error instanceof Error ? error.message : String(error)}\\n\\nProvided args: ${opts.args}`);\n    }\n\n    // 6. Execute tool\n    if (!opts.json) {\n      console.log(`🔧 Calling ${opts.tool}...`);\n    }\n\n    let response: ToolResponseWrapper;\n    try {\n      response = await client.callTool(opts.tool, toolArgs);\n    } catch (error) {\n      handleToolError(error, opts);\n      throw error;\n    }\n\n    const parsedResult = parseToolResult(response);\n\n    if (parsedResult !== undefined) {\n      // Success case\n      if (opts.json) {\n        // JSON output mode\n        console.log(JSON.stringify(parsedResult, null, 2));\n      } else {\n        // Human-readable output\n        console.log(`✅ ${opts.tool} succeeded\\n`);\n        console.log('Result:');\n        if (typeof parsedResult === 'string') {\n          console.log(parsedResult);\n        } else {\n          console.log(JSON.stringify(parsedResult, null, 2));\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    // 8. 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\nfunction handleToolError(error: unknown, opts: CallToolOptions): void {\n  if (!(error instanceof ToolResponseError)) {\n    return;\n  }\n\n  const errorText = extractToolErrorText(error) || error.message;\n\n  if (opts.json) {\n    console.log(JSON.stringify({ error: errorText }, null, 2));\n  } else {\n    console.log(`❌ ${opts.tool} failed\\n`);\n    console.log(`Error: ${errorText}`);\n  }\n}\n\nfunction extractToolErrorText(error: ToolResponseError): string | undefined {\n  const content = Array.isArray(error.response.content) ? error.response.content : [];\n  const first = content[0] as { type?: string; text?: unknown } | undefined;\n  if (first?.type === 'text' && typeof first.text === 'string') {\n    return first.text;\n  }\n  return undefined;\n}\n\nfunction parseToolResult(response: ToolResponseWrapper): unknown | undefined {\n  try {\n    return response.json();\n  } catch (error) {\n    if (error instanceof ToolResponseError) {\n      if ('isError' in error.response && error.response.isError) {\n        throw error;\n      }\n      try {\n        return response.text();\n      } catch {\n        return undefined;\n      }\n    }\n    throw error;\n  }\n}\n"],"names":["createServerRegistry","ToolResponseError","resolveServerConfig","isHttpServer","callToolCommand","opts","registry","client","serverName","serverConfig","configDir","start","Date","now","json","console","log","command","Error","cwd","connect","elapsed","toFixed","toolArgs","parsed","JSON","parse","args","error","message","String","tool","response","callTool","handleToolError","parsedResult","parseToolResult","undefined","stringify","close","_","errorText","extractToolErrorText","content","Array","isArray","first","type","text","isError"],"mappings":"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"}

package/dist/esm/commands/get-prompt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * get-prompt.ts
+ *
+ * Get MCP prompts 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 GetPromptOptions extends InlineConfigOptions {
+    name: string;
+    args: string;
+    json?: boolean;
+}
+/**
+ * Main get-prompt command implementation.
+ *
+ * @param opts - Get prompt options from CLI flags
+ *
+ * @example
+ * // Get a prompt with JSON args
+ * await getPromptCommand({
+ *   server: 'assistant',
+ *   name: 'compose-email',
+ *   args: '{"tone": "formal"}',
+ * });
+ */
+export declare function getPromptCommand(opts: GetPromptOptions): Promise<void>;

package/dist/esm/commands/get-prompt.js

@@ -0,0 +1,118 @@
+/**
+ * get-prompt.ts
+ *
+ * Get MCP prompts from the command line.
+ * Supports stdio (spawned) and http (remote) servers per MCP spec.
+ */ import { createServerRegistry } from '@mcp-z/client';
+import { resolveServerConfig } from '../lib/resolve-server-config.js';
+import { isHttpServer } from '../types.js';
+/**
+ * Main get-prompt command implementation.
+ *
+ * @param opts - Get prompt options from CLI flags
+ *
+ * @example
+ * // Get a prompt with JSON args
+ * await getPromptCommand({
+ *   server: 'assistant',
+ *   name: 'compose-email',
+ *   args: '{"tone": "formal"}',
+ * });
+ */ export async function getPromptCommand(opts) {
+    let registry;
+    let client;
+    try {
+        // 1. Resolve server configuration (from config file or inline options)
+        const { serverName, serverConfig, configDir } = resolveServerConfig(opts);
+        // 2. Create registry and connect
+        const start = Date.now();
+        if (isHttpServer(serverConfig)) {
+            // HTTP server - no spawning needed
+            if (!opts.json) {
+                console.log(`🔗 Connecting to ${serverName}...`);
+            }
+        } else {
+            // Stdio server - will be spawned
+            if (!opts.json) {
+                console.log(`🚀 Spawning ${serverName} server...`);
+            }
+            if (!serverConfig.command) {
+                throw new Error(`Stdio server ${serverName} missing required "command" field`);
+            }
+        }
+        // Create registry (spawns stdio servers, registers HTTP servers)
+        registry = createServerRegistry({
+            [serverName]: serverConfig
+        }, {
+            cwd: configDir
+        });
+        client = await registry.connect(serverName);
+        if (!isHttpServer(serverConfig) && !opts.json) {
+            const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+            console.log(`✓ Server ready in ${elapsed}s\n`);
+        }
+        // 5. Parse prompt arguments
+        let promptArgs;
+        if (opts.args && opts.args !== '{}') {
+            try {
+                const parsed = JSON.parse(opts.args);
+                if (typeof parsed !== 'object' || parsed === null) {
+                    throw new Error('Arguments must be a JSON object');
+                }
+                promptArgs = parsed;
+            } catch (error) {
+                throw new Error(`Failed to parse prompt arguments as JSON: ${error instanceof Error ? error.message : String(error)}\n\nProvided args: ${opts.args}`);
+            }
+        }
+        // 6. Get prompt
+        if (!opts.json) {
+            console.log(`💬 Getting ${opts.name}...`);
+        }
+        const promptResponse = await client.getPrompt(opts.name, promptArgs);
+        const prompt = promptResponse.raw();
+        // Success case
+        if (opts.json) {
+            // JSON output mode
+            console.log(JSON.stringify(prompt, null, 2));
+        } else {
+            // Human-readable output
+            console.log('✅ Get prompt succeeded\n');
+            // Display description if available
+            if (prompt.description) {
+                console.log(`Description: ${prompt.description}\n`);
+            }
+            // Display messages
+            console.log('Messages:');
+            for (const message of prompt.messages){
+                console.log(`  [${message.role}]:`);
+                if (typeof message.content === 'string') {
+                    console.log(`    ${message.content}`);
+                } else if (message.content.type === 'text') {
+                    console.log(`    ${message.content.text}`);
+                } else if (message.content.type === 'image') {
+                    console.log(`    [Image: ${message.content.mimeType}]`);
+                } else if (message.content.type === 'resource') {
+                    console.log(`    [Resource: ${message.content.resource.uri}]`);
+                }
+            }
+        }
+    } catch (error) {
+        if (opts.json) {
+            console.log(JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+            }, null, 2));
+        } else {
+            console.error(`\n❌ ${error instanceof Error ? error.message : String(error)}`);
+        }
+        throw error;
+    } finally{
+        // 8. Cleanup - registry.close() handles both client and server close
+        if (registry) {
+            try {
+                await registry.close();
+            } catch (_) {
+            // Ignore close errors
+            }
+        }
+    }
+}

package/dist/esm/commands/get-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/cli/src/commands/get-prompt.ts"],"sourcesContent":["/**\n * get-prompt.ts\n *\n * Get MCP prompts from the command line.\n * Supports stdio (spawned) and http (remote) servers per MCP spec.\n */\n\nimport { createServerRegistry, type ManagedClient, type PromptArguments, type ServerRegistry } from '@mcp-z/client';\nimport { type InlineConfigOptions, resolveServerConfig } from '../lib/resolve-server-config.ts';\nimport { isHttpServer } from '../types.ts';\n\nexport interface GetPromptOptions extends InlineConfigOptions {\n  name: string; // Prompt name (positional)\n  args: string; // JSON args (positional)\n  json?: boolean; // --json\n}\n\n/**\n * Main get-prompt command implementation.\n *\n * @param opts - Get prompt options from CLI flags\n *\n * @example\n * // Get a prompt with JSON args\n * await getPromptCommand({\n *   server: 'assistant',\n *   name: 'compose-email',\n *   args: '{\"tone\": \"formal\"}',\n * });\n */\nexport async function getPromptCommand(opts: GetPromptOptions): 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. Parse prompt arguments\n    let promptArgs: PromptArguments | undefined;\n    if (opts.args && opts.args !== '{}') {\n      try {\n        const parsed = JSON.parse(opts.args);\n        if (typeof parsed !== 'object' || parsed === null) {\n          throw new Error('Arguments must be a JSON object');\n        }\n        promptArgs = parsed;\n      } catch (error) {\n        throw new Error(`Failed to parse prompt arguments as JSON: ${error instanceof Error ? error.message : String(error)}\\n\\nProvided args: ${opts.args}`);\n      }\n    }\n\n    // 6. Get prompt\n    if (!opts.json) {\n      console.log(`💬 Getting ${opts.name}...`);\n    }\n\n    const promptResponse = await client.getPrompt(opts.name, promptArgs);\n    const prompt = promptResponse.raw();\n\n    // Success case\n    if (opts.json) {\n      // JSON output mode\n      console.log(JSON.stringify(prompt, null, 2));\n    } else {\n      // Human-readable output\n      console.log('✅ Get prompt succeeded\\n');\n\n      // Display description if available\n      if (prompt.description) {\n        console.log(`Description: ${prompt.description}\\n`);\n      }\n\n      // Display messages\n      console.log('Messages:');\n      for (const message of prompt.messages) {\n        console.log(`  [${message.role}]:`);\n        if (typeof message.content === 'string') {\n          console.log(`    ${message.content}`);\n        } else if (message.content.type === 'text') {\n          console.log(`    ${message.content.text}`);\n        } else if (message.content.type === 'image') {\n          console.log(`    [Image: ${message.content.mimeType}]`);\n        } else if (message.content.type === 'resource') {\n          console.log(`    [Resource: ${message.content.resource.uri}]`);\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    // 8. 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":["createServerRegistry","resolveServerConfig","isHttpServer","getPromptCommand","opts","registry","client","serverName","serverConfig","configDir","start","Date","now","json","console","log","command","Error","cwd","connect","elapsed","toFixed","promptArgs","args","parsed","JSON","parse","error","message","String","name","promptResponse","getPrompt","prompt","raw","stringify","description","messages","role","content","type","text","mimeType","resource","uri","close","_"],"mappings":"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"}

package/dist/esm/commands/inspect.d.ts

@@ -0,0 +1,35 @@
+/**
+ * inspect.ts
+ *
+ * Inspect MCP servers: explore tools, resources, prompts, and health status.
+ * Supports stdio (spawned) and http (remote) servers per MCP spec.
+ */
+export interface InspectOptions {
+    config?: string;
+    servers?: string;
+    tools?: boolean;
+    resources?: boolean;
+    prompts?: boolean;
+    health?: boolean;
+    json?: boolean;
+    verbose?: boolean;
+    attach?: boolean;
+}
+/**
+ * Main inspect command implementation.
+ *
+ * @param opts - Inspect options from CLI flags
+ *
+ * @example
+ * // Show summary of .mcp.json servers (spawns servers)
+ * await inspectCommand({});
+ *
+ * @example
+ * // Show all tools from echo server (spawns server)
+ * await inspectCommand({ servers: 'echo', tools: true });
+ *
+ * @example
+ * // Connect to running servers (attach mode)
+ * await inspectCommand({ config: 'http-servers.json', attach: true, health: true });
+ */
+export declare function inspectCommand(opts?: InspectOptions): Promise<void>;