@slbdn/mcp-tester 1.0.1 → 1.1.0

package/dist/assert.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Standalone assertion utilities for MCP tool/resource/prompt testing.
+ *
+ * Works with any test runner — just throws descriptive errors on failure.
+ * Designed for the `runTest(name, fn)` pattern:
+ *
+ *   await runTest("Get constant: c", async () => {
+ *     const result = await client.callTool({ name: "get_constant", arguments: { name: "c" } });
+ *     assertToolText(result, "299792458");
+ *   });
+ *
+ * @module assert
+ */
+import type { CallToolResult, ReadResourceResult, GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
+/** Thrown when an assertion fails. */
+export declare class AssertionError extends Error {
+    constructor(message: string);
+}
+/** Assert that `actual === expected` (strict equality). */
+export declare function equal<T>(actual: T, expected: T, msg?: string): void;
+/** Assert that `actual !== expected`. */
+export declare function notEqual<T>(actual: T, expected: T, msg?: string): void;
+/** Assert that `actual` is deeply equal to `expected`. */
+export declare function deepEqual(actual: unknown, expected: unknown, msg?: string): void;
+/** Assert that `value` is truthy. */
+export declare function ok(value: unknown, msg?: string): void;
+/** Assert that `value` is falsy. */
+export declare function notOk(value: unknown, msg?: string): void;
+/** Assert that `fn` throws an error. Returns the error for further assertions. */
+export declare function throws(fn: () => Promise<unknown>, msg?: string): Promise<Error>;
+/** Assert that `fn` does NOT throw. */
+export declare function doesNotThrow(fn: () => Promise<unknown>, msg?: string): Promise<void>;
+/** Assert that `actual === expected` (numbers). */
+export declare function equalNum(actual: number, expected: number, msg?: string): void;
+/** Assert `actual > expected`. */
+export declare function greaterThan(actual: number, expected: number, msg?: string): void;
+/** Assert `actual >= expected`. */
+export declare function atLeast(actual: number, expected: number, msg?: string): void;
+/** Assert `actual < expected`. */
+export declare function lessThan(actual: number, expected: number, msg?: string): void;
+/** Assert `value` is within `epsilon` of `expected`. */
+export declare function closeTo(actual: number, expected: number, epsilon?: number, msg?: string): void;
+/** Assert that `str` contains `substring`. */
+export declare function contains(str: string, substring: string, msg?: string): void;
+/** Assert that `str` does NOT contain `substring`. */
+export declare function notContains(str: string, substring: string, msg?: string): void;
+/** Assert that `str` matches `regex`. */
+export declare function matches(str: string, regex: RegExp, msg?: string): void;
+/** Assert tool result text equals expected string exactly. If expected omitted, just checks for text content. */
+export declare function toolTextEquals(result: CallToolResult, expected?: string, msg?: string): void;
+/** Assert tool result text contains expected substring. */
+export declare function toolTextContains(result: CallToolResult, substring: string, msg?: string): void;
+/** Assert tool result text, parsed as number, equals expected. */
+export declare function toolNumEquals(result: CallToolResult, expected: number, msg?: string): void;
+/** Assert tool result text, parsed as number, is within epsilon of expected. */
+export declare function toolNumCloseTo(result: CallToolResult, expected: number, epsilon?: number, msg?: string): void;
+/** Assert tool result text, parsed as JSON, deeply equals expected. */
+export declare function toolJsonEquals<T = unknown>(result: CallToolResult, expected: T, msg?: string): void;
+/** Assert tool returned an error (isError flag or error in text). */
+export declare function toolIsError(result: CallToolResult, msg?: string): void;
+/** Assert tool did NOT return an error. */
+export declare function toolIsOk(result: CallToolResult, msg?: string): void;
+/** Assert tool result has at least `minItems` content items. */
+export declare function toolHasContent(result: CallToolResult, minItems?: number, msg?: string): void;
+/** Assert tool result contains an image content item. */
+export declare function toolHasImage(result: CallToolResult, msg?: string): void;
+/** Assert resource result has content. */
+export declare function resourceHasContent(result: ReadResourceResult, minItems?: number, msg?: string): void;
+/** Assert resource result text contains substring. */
+export declare function resourceTextContains(result: ReadResourceResult, substring: string, msg?: string): void;
+/** Assert prompt result has messages. */
+export declare function promptHasMessages(result: GetPromptResult, minMessages?: number, msg?: string): void;
+/** Assert prompt result text contains substring. */
+export declare function promptTextContains(result: GetPromptResult, substring: string, msg?: string): void;
+//# sourceMappingURL=assert.d.ts.map

package/dist/assert.d.ts.map

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

package/dist/assert.js

@@ -0,0 +1,250 @@
+/**
+ * Standalone assertion utilities for MCP tool/resource/prompt testing.
+ *
+ * Works with any test runner — just throws descriptive errors on failure.
+ * Designed for the `runTest(name, fn)` pattern:
+ *
+ *   await runTest("Get constant: c", async () => {
+ *     const result = await client.callTool({ name: "get_constant", arguments: { name: "c" } });
+ *     assertToolText(result, "299792458");
+ *   });
+ *
+ * @module assert
+ */
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function extractText(result) {
+    const item = result.content[0];
+    if (item && 'text' in item)
+        return item.text;
+    throw new AssertionError(`Tool result has no text content. Got: ${JSON.stringify(result.content[0])}`);
+}
+function fail(message) {
+    throw new AssertionError(message);
+}
+// ─── Error Class ────────────────────────────────────────────────────────────
+/** Thrown when an assertion fails. */
+export class AssertionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AssertionError';
+    }
+}
+// ─── Value Assertions ───────────────────────────────────────────────────────
+/** Assert that `actual === expected` (strict equality). */
+export function equal(actual, expected, msg) {
+    if (actual !== expected) {
+        fail(msg ?? `Expected ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+    }
+}
+/** Assert that `actual !== expected`. */
+export function notEqual(actual, expected, msg) {
+    if (actual === expected) {
+        fail(msg ?? `Expected value to NOT equal ${JSON.stringify(expected)}`);
+    }
+}
+/** Assert that `actual` is deeply equal to `expected`. */
+export function deepEqual(actual, expected, msg) {
+    if (JSON.stringify(actual) !== JSON.stringify(expected)) {
+        fail(msg ??
+            `Expected deep equality:\n  actual:   ${JSON.stringify(actual)}\n  expected: ${JSON.stringify(expected)}`);
+    }
+}
+/** Assert that `value` is truthy. */
+export function ok(value, msg) {
+    if (!value) {
+        fail(msg ?? `Expected truthy value, got ${JSON.stringify(value)}`);
+    }
+}
+/** Assert that `value` is falsy. */
+export function notOk(value, msg) {
+    if (value) {
+        fail(msg ?? `Expected falsy value, got ${JSON.stringify(value)}`);
+    }
+}
+/** Assert that `fn` throws an error. Returns the error for further assertions. */
+export async function throws(fn, msg) {
+    try {
+        await fn();
+        fail(msg ?? 'Expected function to throw, but it did not');
+    }
+    catch (error) {
+        if (error instanceof AssertionError)
+            throw error;
+        return error;
+    }
+}
+/** Assert that `fn` does NOT throw. */
+export async function doesNotThrow(fn, msg) {
+    try {
+        await fn();
+    }
+    catch (error) {
+        fail(msg ?? `Expected function NOT to throw, but it threw: ${error}`);
+    }
+}
+// ─── Numeric Assertions ─────────────────────────────────────────────────────
+/** Assert that `actual === expected` (numbers). */
+export function equalNum(actual, expected, msg) {
+    if (actual !== expected) {
+        fail(msg ?? `Expected ${expected}, got ${actual}`);
+    }
+}
+/** Assert `actual > expected`. */
+export function greaterThan(actual, expected, msg) {
+    if (actual <= expected) {
+        fail(msg ?? `Expected ${actual} > ${expected}`);
+    }
+}
+/** Assert `actual >= expected`. */
+export function atLeast(actual, expected, msg) {
+    if (actual < expected) {
+        fail(msg ?? `Expected ${actual} >= ${expected}`);
+    }
+}
+/** Assert `actual < expected`. */
+export function lessThan(actual, expected, msg) {
+    if (actual >= expected) {
+        fail(msg ?? `Expected ${actual} < ${expected}`);
+    }
+}
+/** Assert `value` is within `epsilon` of `expected`. */
+export function closeTo(actual, expected, epsilon = 0.001, msg) {
+    if (Math.abs(actual - expected) > epsilon) {
+        fail(msg ?? `Expected ${actual} to be within ${epsilon} of ${expected}`);
+    }
+}
+// ─── String Assertions ──────────────────────────────────────────────────────
+/** Assert that `str` contains `substring`. */
+export function contains(str, substring, msg) {
+    if (!str.includes(substring)) {
+        fail(msg ?? `Expected string to contain "${substring}". Got: "${str}"`);
+    }
+}
+/** Assert that `str` does NOT contain `substring`. */
+export function notContains(str, substring, msg) {
+    if (str.includes(substring)) {
+        fail(msg ?? `Expected string to NOT contain "${substring}". Got: "${str}"`);
+    }
+}
+/** Assert that `str` matches `regex`. */
+export function matches(str, regex, msg) {
+    if (!regex.test(str)) {
+        fail(msg ?? `Expected string to match ${regex}. Got: "${str}"`);
+    }
+}
+// ─── MCP Tool Assertions ────────────────────────────────────────────────────
+/** Assert tool result text equals expected string exactly. If expected omitted, just checks for text content. */
+export function toolTextEquals(result, expected, msg) {
+    const text = extractText(result);
+    if (text === undefined) {
+        fail(msg ?? 'Expected tool result to have text content');
+    }
+    if (expected !== undefined && text !== expected) {
+        fail(msg ?? `Expected tool text "${expected}", got "${text}"`);
+    }
+}
+/** Assert tool result text contains expected substring. */
+export function toolTextContains(result, substring, msg) {
+    const text = extractText(result);
+    if (!text.includes(substring)) {
+        fail(msg ?? `Expected tool text to contain "${substring}". Got: "${text}"`);
+    }
+}
+/** Assert tool result text, parsed as number, equals expected. */
+export function toolNumEquals(result, expected, msg) {
+    const text = extractText(result);
+    const actual = parseFloat(text);
+    if (Number.isNaN(actual)) {
+        fail(msg ?? `Expected tool text to be a number. Got: "${text}"`);
+    }
+    if (actual !== expected) {
+        fail(msg ?? `Expected tool result ${expected}, got ${actual}`);
+    }
+}
+/** Assert tool result text, parsed as number, is within epsilon of expected. */
+export function toolNumCloseTo(result, expected, epsilon = 0.001, msg) {
+    const text = extractText(result);
+    const actual = parseFloat(text);
+    if (Number.isNaN(actual)) {
+        fail(msg ?? `Expected tool text to be a number. Got: "${text}"`);
+    }
+    if (Math.abs(actual - expected) > epsilon) {
+        fail(msg ?? `Expected tool result within ${epsilon} of ${expected}, got ${actual}`);
+    }
+}
+/** Assert tool result text, parsed as JSON, deeply equals expected. */
+export function toolJsonEquals(result, expected, msg) {
+    const text = extractText(result);
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        fail(msg ?? `Expected tool text to be valid JSON. Got: "${text}"`);
+    }
+    if (JSON.stringify(parsed) !== JSON.stringify(expected)) {
+        fail(msg ?? `Expected tool JSON ${JSON.stringify(expected)}, got ${JSON.stringify(parsed)}`);
+    }
+}
+/** Assert tool returned an error (isError flag or error in text). */
+export function toolIsError(result, msg) {
+    if (!result.isError && !extractText(result).toLowerCase().includes('error')) {
+        fail(msg ?? 'Expected tool result to be an error');
+    }
+}
+/** Assert tool did NOT return an error. */
+export function toolIsOk(result, msg) {
+    if (result.isError) {
+        fail(msg ?? `Expected tool result to be successful, but got error: ${extractText(result)}`);
+    }
+}
+/** Assert tool result has at least `minItems` content items. */
+export function toolHasContent(result, minItems = 1, msg) {
+    if (result.content.length < minItems) {
+        fail(msg ?? `Expected at least ${minItems} content items, got ${result.content.length}`);
+    }
+}
+/** Assert tool result contains an image content item. */
+export function toolHasImage(result, msg) {
+    const hasImage = result.content.some((item) => item.type === 'image');
+    if (!hasImage) {
+        fail(msg ?? 'Expected tool result to contain an image');
+    }
+}
+// ─── MCP Resource Assertions ────────────────────────────────────────────────
+/** Assert resource result has content. */
+export function resourceHasContent(result, minItems = 1, msg) {
+    if (result.contents.length < minItems) {
+        fail(msg ?? `Expected at least ${minItems} resource contents, got ${result.contents.length}`);
+    }
+}
+/** Assert resource result text contains substring. */
+export function resourceTextContains(result, substring, msg) {
+    const item = result.contents[0];
+    if (!item || !('text' in item)) {
+        fail(msg ?? 'Resource result has no text content');
+    }
+    const text = item.text;
+    if (!text.includes(substring)) {
+        fail(msg ?? `Expected resource text to contain "${substring}". Got: "${text}"`);
+    }
+}
+// ─── MCP Prompt Assertions ──────────────────────────────────────────────────
+/** Assert prompt result has messages. */
+export function promptHasMessages(result, minMessages = 1, msg) {
+    if (result.messages.length < minMessages) {
+        fail(msg ?? `Expected at least ${minMessages} prompt messages, got ${result.messages.length}`);
+    }
+}
+/** Assert prompt result text contains substring. */
+export function promptTextContains(result, substring, msg) {
+    const item = result.messages[0]?.content;
+    if (!item || !('text' in item)) {
+        fail(msg ?? 'Prompt message has no text content');
+    }
+    const text = item.text;
+    if (!text.includes(substring)) {
+        fail(msg ?? `Expected prompt text to contain "${substring}". Got: "${text}"`);
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/assert.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+// CLI entry point - run with: node dist/cli/index.js
+import { Command } from 'commander';
+import { MCPClient } from '../client/MCPClient.js';
+import { MCPConnectionError, MCPTimeoutError, MCPServerError } from '../utils/errors.js';
+const program = new Command();
+program
+    .name('mcp-tester')
+    .description('CLI tool for testing MCP servers')
+    .version('1.0.0', '-V, --version');
+// Global options - use string type since commander passes strings
+program
+    .option('-t, --timeout <ms>', 'Request timeout in milliseconds', '30000')
+    .option('-v, --verbose', 'Enable verbose output')
+    .option('-l, --log-level <level>', 'Log level (debug|info|warn|error)', 'info');
+// Test command - connects and verifies server is working
+program
+    .command('test')
+    .description('Test MCP server connection and list available capabilities')
+    .argument('<command>', 'Command to run the MCP server (e.g., "node", "python")')
+    .argument('[args...]', 'Arguments for the server command')
+    .action(async (command, args, opts) => {
+    const client = new MCPClient({
+        name: 'mcp-tester-cli',
+        version: '1.0.0',
+        timeout: parseInt(String(opts['timeout'] || '30000')),
+        logLevel: (opts['verbose'] ? 'debug' : String(opts['logLevel'] || 'info')),
+    });
+    try {
+        console.log(`🔌 Connecting to MCP server...`);
+        console.log(`   Command: ${command} ${args.join(' ')}`);
+        await client.start({
+            command,
+            args,
+        });
+        console.log(`✅ Connected successfully\n`);
+        // Test tools
+        console.log(`🛠️  Tools:`);
+        const tools = await client.listTools();
+        if (tools.length === 0) {
+            console.log('   (none)');
+        }
+        else {
+            tools.forEach((tool) => {
+                console.log(`   • ${tool.name}: ${tool.description}`);
+            });
+        }
+        console.log();
+        // Test resources
+        console.log(`📄 Resources:`);
+        const resources = await client.listResources();
+        if (resources.length === 0) {
+            console.log('   (none)');
+        }
+        else {
+            resources.forEach((resource) => {
+                console.log(`   • ${resource.uri}: ${resource.description || resource.name}`);
+            });
+        }
+        console.log();
+        // Test prompts
+        console.log(`💬 Prompts:`);
+        const prompts = await client.listPrompts();
+        if (prompts.length === 0) {
+            console.log('   (none)');
+        }
+        else {
+            prompts.forEach((prompt) => {
+                console.log(`   • ${prompt.name}: ${prompt.description}`);
+            });
+        }
+        console.log();
+        console.log(`✅ Server test completed successfully!`);
+        console.log(`   Tools: ${tools.length} | Resources: ${resources.length} | Prompts: ${prompts.length}`);
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        if (error instanceof MCPConnectionError) {
+            console.error('   → Server failed to start. Check command and server process.');
+        }
+        else if (error instanceof MCPTimeoutError) {
+            console.error(`   → Request timed out after ${opts['timeout']}ms`);
+        }
+        else if (error instanceof MCPServerError) {
+            console.error('   → Server returned an error');
+        }
+        process.exit(1);
+    }
+    finally {
+        await client.stop();
+    }
+});
+// List tools command
+program
+    .command('list-tools')
+    .alias('lt')
+    .description('List all available tools from the MCP server')
+    .argument('<command>', 'Command to run the MCP server')
+    .argument('[args...]', 'Arguments for the server command')
+    .option('--json', 'Output as JSON')
+    .action(async (command, args, opts) => {
+    const client = new MCPClient({
+        name: 'mcp-tester-cli',
+        version: '1.0.0',
+        timeout: parseInt(String(opts['timeout'] || '30000')),
+        logLevel: opts['verbose'] ? 'debug' : 'info',
+    });
+    try {
+        await client.start({ command, args });
+        const tools = await client.listTools();
+        if (opts['json']) {
+            console.log(JSON.stringify({ tools }, null, 2));
+        }
+        else {
+            console.log(`🛠️  Available tools (${tools.length}):\n`);
+            tools.forEach((tool) => {
+                console.log(`  ${tool.name}`);
+                console.log(`    Description: ${tool.description}`);
+                if (tool.inputSchema?.properties) {
+                    const props = Object.keys(tool.inputSchema.properties);
+                    console.log(`    Parameters: ${props.join(', ') || '(none)'}`);
+                }
+                console.log();
+            });
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    finally {
+        await client.stop();
+    }
+});
+// Call tool command
+program
+    .command('call-tool')
+    .alias('ct')
+    .description('Call a tool on the MCP server')
+    .argument('<tool-name>', 'Name of the tool to call')
+    .argument('<command>', 'Command to run the MCP server')
+    .argument('[args...]', 'Arguments for the server command')
+    .option('--params <json>', 'Tool parameters as JSON string')
+    .option('--json', 'Output as JSON')
+    .action(async (toolName, command, serverArgs, opts) => {
+    const client = new MCPClient({
+        name: 'mcp-tester-cli',
+        version: '1.0.0',
+        timeout: parseInt(String(opts['timeout'] || '30000')),
+        logLevel: opts['verbose'] ? 'debug' : 'info',
+    });
+    let toolArgs = {};
+    if (opts['params']) {
+        try {
+            toolArgs = JSON.parse(String(opts['params']));
+        }
+        catch {
+            console.error('❌ Invalid JSON for --params');
+            process.exit(1);
+        }
+    }
+    try {
+        await client.start({ command, args: serverArgs });
+        if (!opts['json']) {
+            console.log(`🔧 Calling tool: ${toolName}`);
+            if (Object.keys(toolArgs).length > 0) {
+                console.log(`   Parameters: ${JSON.stringify(toolArgs)}`);
+            }
+        }
+        const result = await client.callTool({
+            name: toolName,
+            arguments: toolArgs,
+        });
+        if (opts['json']) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log('\n✅ Result:');
+            result.content.forEach((item) => {
+                if ('text' in item) {
+                    console.log(`   ${item.text}`);
+                }
+                else if ('data' in item) {
+                    console.log(`   ${JSON.stringify(item.data)}`);
+                }
+            });
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    finally {
+        await client.stop();
+    }
+});
+// Read resource command
+program
+    .command('read-resource')
+    .alias('rr')
+    .description('Read a resource from the MCP server')
+    .argument('<uri>', 'URI of the resource to read')
+    .argument('<command>', 'Command to run the MCP server')
+    .argument('[args...]', 'Arguments for the server command')
+    .option('--json', 'Output as JSON')
+    .action(async (uri, command, serverArgs, opts) => {
+    const client = new MCPClient({
+        name: 'mcp-tester-cli',
+        version: '1.0.0',
+        timeout: parseInt(String(opts['timeout'] || '30000')),
+        logLevel: opts['verbose'] ? 'debug' : 'info',
+    });
+    try {
+        await client.start({ command, args: serverArgs });
+        if (!opts['json']) {
+            console.log(`📖 Reading resource: ${uri}`);
+        }
+        const result = await client.readResource(uri);
+        if (opts['json']) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            result.contents.forEach((item) => {
+                if ('text' in item) {
+                    console.log('\n📄 Content:');
+                    console.log(`   ${item.text}`);
+                }
+            });
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    finally {
+        await client.stop();
+    }
+});
+// Get prompt command
+program
+    .command('get-prompt')
+    .alias('gp')
+    .description('Get a prompt from the MCP server')
+    .argument('<name>', 'Name of the prompt')
+    .argument('<command>', 'Command to run the MCP server')
+    .argument('[args...]', 'Arguments for the server command')
+    .option('--args <json>', 'Prompt arguments as JSON string')
+    .option('--json', 'Output as JSON')
+    .action(async (promptName, command, serverArgs, opts) => {
+    const client = new MCPClient({
+        name: 'mcp-tester-cli',
+        version: '1.0.0',
+        timeout: parseInt(String(opts['timeout'] || '30000')),
+        logLevel: opts['verbose'] ? 'debug' : 'info',
+    });
+    let promptArgs = {};
+    if (opts['args']) {
+        try {
+            promptArgs = JSON.parse(String(opts['args']));
+        }
+        catch {
+            console.error('❌ Invalid JSON for --args');
+            process.exit(1);
+        }
+    }
+    try {
+        await client.start({ command, args: serverArgs });
+        if (!opts['json']) {
+            console.log(`💬 Getting prompt: ${promptName}`);
+        }
+        const result = await client.getPrompt(promptName, promptArgs);
+        if (opts['json']) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log('\n📝 Messages:');
+            result.messages.forEach((msg) => {
+                console.log(`   [${msg.role}]`);
+                if ('text' in msg.content) {
+                    console.log(`   ${msg.content.text}`);
+                }
+            });
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    finally {
+        await client.stop();
+    }
+});
+// Add custom help with examples using Commander's built-in help system
+program.addHelpText('after', `
+Examples:
+  mcp-tester test node ./server.js
+  mcp-tester list-tools node ./server.js --json
+  mcp-tester call-tool echo node ./server.js --params '{"message":"Hello"}'
+  mcp-tester read-resource text://example node ./server.js
+  mcp-tester get-prompt greet node ./server.js --args '{"name":"World"}'
+  mcp-tester lt node ./server.js                          # short alias for list-tools
+  mcp-tester ct echo node ./server.js --params '{}'       # short alias for call-tool
+`);
+// Show help when invoked with no arguments
+const args = process.argv.slice(2);
+if (args.length === 0) {
+    program.outputHelp();
+    process.exit(0);
+}
+program.parse();
+//# sourceMappingURL=index.js.map