@mcp-consultant-tools/rest-api 28.0.0-beta.7 → 28.0.0

package/build/cli/commands/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CLI Commands barrel export + combined registration
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerAllCommands(program: Command, ctx: ServiceContext): void;
+export { registerRestCommands } from './rest-commands.js';
+//# sourceMappingURL=index.d.ts.map

package/build/cli/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAE/E;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/build/cli/commands/index.js

@@ -0,0 +1,9 @@
+/**
+ * CLI Commands barrel export + combined registration
+ */
+import { registerRestCommands } from './rest-commands.js';
+export function registerAllCommands(program, ctx) {
+    registerRestCommands(program, ctx);
+}
+export { registerRestCommands } from './rest-commands.js';
+//# sourceMappingURL=index.js.map

package/build/cli/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,GAAmB;IACvE,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/build/cli/commands/rest-commands.d.ts

@@ -0,0 +1,7 @@
+/**
+ * REST API CLI Commands - 6 commands mapping to REST API MCP tools
+ */
+import type { Command } from 'commander';
+import type { ServiceContext } from '../../types.js';
+export declare function registerRestCommands(program: Command, ctx: ServiceContext): void;
+//# sourceMappingURL=rest-commands.d.ts.map

package/build/cli/commands/rest-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/rest-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAoOhF"}

package/build/cli/commands/rest-commands.js

@@ -0,0 +1,212 @@
+/**
+ * REST API CLI Commands - 6 commands mapping to REST API MCP tools
+ */
+import { getGlobalFlags, handleCliError } from '@mcp-consultant-tools/core';
+import { outputResult } from '../output.js';
+export function registerRestCommands(program, ctx) {
+    // Command: request (maps to rest-request tool)
+    program
+        .command('request')
+        .description('Execute a REST API request with automatic authentication')
+        .argument('<method>', 'HTTP method (GET, POST, PUT, DELETE, PATCH)')
+        .argument('<endpoint>', 'Endpoint path (e.g., /api/users)')
+        .option('-b, --body <json>', 'Request body as JSON string')
+        .option('-H, --header <key=value...>', 'Additional headers (repeatable)', collectHeaders, {})
+        .option('--host <url>', 'Override base URL for this request')
+        .action(async (method, endpoint, opts) => {
+        try {
+            const upperMethod = method.toUpperCase();
+            if (!['GET', 'POST', 'PUT', 'DELETE', 'PATCH'].includes(upperMethod)) {
+                throw new Error(`Invalid HTTP method: ${method}. Use GET, POST, PUT, DELETE, or PATCH.`);
+            }
+            // Validate endpoint doesn't contain full URL
+            const urlPattern = /^(https?:\/\/|www\.)/i;
+            if (urlPattern.test(endpoint)) {
+                throw new Error('Invalid endpoint format. Do not include full URLs. Use just the path (e.g., "/api/users") and optionally specify --host to override the base URL.');
+            }
+            let body;
+            if (opts.body) {
+                try {
+                    body = JSON.parse(opts.body);
+                }
+                catch {
+                    body = opts.body;
+                }
+            }
+            const options = {
+                method: upperMethod,
+                endpoint,
+                body,
+                headers: Object.keys(opts.header).length > 0 ? opts.header : undefined,
+                host: opts.host,
+            };
+            const result = await ctx.restApi.request(options);
+            outputResult({
+                fileName: `request-${upperMethod}-${endpoint.replace(/\//g, '-').replace(/^-/, '')}`,
+                data: result,
+                summary: `${upperMethod} ${endpoint} => ${result.response.statusCode} ${result.response.statusText} (${result.response.timing})`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'REST request');
+        }
+    });
+    // Command: config (maps to rest-config tool)
+    program
+        .command('config')
+        .description('Get the current REST API service configuration summary')
+        .action(async () => {
+        try {
+            const summary = ctx.restApi.getConfigSummary();
+            outputResult({
+                fileName: 'rest-config',
+                data: summary,
+                summary: `Base URL: ${summary.baseUrl}\nAuth method: ${summary.authMethod}\nSSL verification: ${summary.sslVerification}\nResponse size limit: ${summary.responseSizeLimit}`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'get config');
+        }
+    });
+    // Command: refresh-token (maps to rest-refresh-token tool)
+    program
+        .command('refresh-token')
+        .description('Force refresh the OAuth2 access token')
+        .action(async () => {
+        try {
+            const authMethod = ctx.restApi.getAuthMethod();
+            if (authMethod !== 'oauth2') {
+                throw new Error(`Token refresh only available for OAuth2 authentication. Current auth method: ${authMethod}`);
+            }
+            ctx.restApi.clearTokenCache();
+            outputResult({
+                fileName: 'refresh-token',
+                data: { message: 'OAuth2 token cache cleared. A new token will be acquired on the next request.' },
+                summary: 'OAuth2 token cache cleared successfully.',
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'refresh token');
+        }
+    });
+    // Command: batch (maps to rest-batch-request tool)
+    program
+        .command('batch')
+        .description('Execute multiple REST API requests sequentially from a JSON file or string')
+        .argument('<requests-json>', 'JSON array of request objects, or path to JSON file')
+        .option('--stop-on-error', 'Stop executing remaining requests if one fails', false)
+        .action(async (requestsJson, opts) => {
+        try {
+            let requests;
+            // Try parsing as JSON string first
+            try {
+                requests = JSON.parse(requestsJson);
+            }
+            catch {
+                // Try reading as file
+                const { readFileSync } = await import('node:fs');
+                const content = readFileSync(requestsJson, 'utf-8');
+                requests = JSON.parse(content);
+            }
+            if (!Array.isArray(requests)) {
+                throw new Error('Requests must be a JSON array of request objects');
+            }
+            const results = [];
+            for (let i = 0; i < requests.length; i++) {
+                const req = requests[i];
+                try {
+                    const result = await ctx.restApi.request(req);
+                    results.push({
+                        index: i,
+                        endpoint: req.endpoint,
+                        success: !result.validation.isError,
+                        result,
+                    });
+                    if (opts.stopOnError && result.validation.isError) {
+                        break;
+                    }
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    results.push({
+                        index: i,
+                        endpoint: req.endpoint,
+                        success: false,
+                        error: errorMessage,
+                    });
+                    if (opts.stopOnError) {
+                        break;
+                    }
+                }
+            }
+            const data = {
+                totalRequests: requests.length,
+                executedRequests: results.length,
+                successfulRequests: results.filter((r) => r.success).length,
+                results,
+            };
+            outputResult({
+                fileName: 'batch-request',
+                data,
+                summary: `Batch: ${data.successfulRequests}/${data.executedRequests} successful (${data.totalRequests} total)`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'batch request');
+        }
+    });
+    // Command: list-endpoints (maps to rest-list-endpoints tool)
+    program
+        .command('list-endpoints')
+        .description('List available REST API endpoints from OpenAPI spec')
+        .option('-f, --filter <text>', 'Filter endpoint paths (case-insensitive contains match)')
+        .action(async (opts) => {
+        try {
+            const result = await ctx.restApi.listEndpointsAsync(opts.filter);
+            outputResult({
+                fileName: `endpoints${opts.filter ? `-${opts.filter}` : ''}`,
+                data: result,
+                summary: `Found ${result.endpointCount} endpoint(s) at ${result.baseUrl}${opts.filter ? ` (filter: '${opts.filter}')` : ''}`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'list endpoints');
+        }
+    });
+    // Command: get-schema (maps to rest-get-schema tool)
+    program
+        .command('get-schema')
+        .description('Get schema/field definitions for a specific entity from OpenAPI spec')
+        .argument('<entity>', 'Entity name (singular or plural)')
+        .action(async (entity) => {
+        try {
+            if (!ctx.restApi.hasOpenApiConfig()) {
+                throw new Error("No schema configuration available. Configure REST_OPENAPI_URL pointing to your API's OpenAPI/Swagger spec.");
+            }
+            const schema = await ctx.restApi.getSchemaAsync(entity);
+            if (!schema) {
+                throw new Error(`Entity '${entity}' not found. Use 'list-endpoints' to see available entities.`);
+            }
+            outputResult({
+                fileName: `schema-${entity}`,
+                data: schema,
+                summary: `Entity: ${schema.entityName} (${schema.pluralName})\nEndpoint: ${schema.endpoint}\nPrimary key: ${schema.primaryKey}\nFields: ${schema.fields.length}`,
+            }, getGlobalFlags(program));
+        }
+        catch (error) {
+            handleCliError(error, 'get schema');
+        }
+    });
+}
+/**
+ * Commander option collector for repeatable --header key=value options
+ */
+function collectHeaders(value, previous) {
+    const [key, ...valueParts] = value.split('=');
+    if (!key || valueParts.length === 0) {
+        throw new Error(`Invalid header format: '${value}'. Use key=value format.`);
+    }
+    previous[key.trim()] = valueParts.join('=').trim();
+    return previous;
+}
+//# sourceMappingURL=rest-commands.js.map

package/build/cli/commands/rest-commands.js.map

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

package/build/cli/output.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI output helper for rest-api package.
+ * Thin wrapper setting the package-specific cache directory.
+ */
+import { type GlobalFlags } from '@mcp-consultant-tools/core';
+export declare function outputResult(opts: {
+    fileName: string;
+    data: unknown;
+    summary: string;
+}, flags: GlobalFlags): void;
+//# sourceMappingURL=output.d.ts.map

package/build/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIhG,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1D,KAAK,EAAE,WAAW,GACjB,IAAI,CAEN"}

package/build/cli/output.js

@@ -0,0 +1,10 @@
+/**
+ * CLI output helper for rest-api package.
+ * Thin wrapper setting the package-specific cache directory.
+ */
+import { outputResult as coreOutputResult } from '@mcp-consultant-tools/core';
+const CACHE_DIR = '.mcp-rest-api-cache';
+export function outputResult(opts, flags) {
+    coreOutputResult({ ...opts, cacheDir: CACHE_DIR }, flags);
+}
+//# sourceMappingURL=output.js.map

package/build/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAoB,MAAM,4BAA4B,CAAC;AAEhG,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAExC,MAAM,UAAU,YAAY,CAC1B,IAA0D,EAC1D,KAAkB;IAElB,gBAAgB,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/build/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @mcp-consultant-tools/rest-api CLI
+ *
+ * Command-line interface for REST API operations.
+ * Reuses the same ServiceContext and services as the MCP server.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/build/cli.d.ts.map

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

package/build/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * @mcp-consultant-tools/rest-api CLI
+ *
+ * Command-line interface for REST API operations.
+ * Reuses the same ServiceContext and services as the MCP server.
+ */
+import { createCliProgram, loadEnvForCli } from '@mcp-consultant-tools/core';
+import { createServiceContext } from './context-factory.js';
+import { registerAllCommands } from './cli/commands/index.js';
+const program = createCliProgram({
+    name: 'mcp-rest-api-cli',
+    description: 'REST API CLI - HTTP requests, config, schema, endpoints',
+    version: '28.0.0-beta.8',
+});
+// Load env before parsing (--env-file handled by commander hook)
+program.hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    loadEnvForCli(opts.envFile);
+});
+const ctx = createServiceContext();
+registerAllCommands(program, ctx);
+program.parseAsync(process.argv).catch((error) => {
+    console.error('CLI error:', error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/build/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,OAAO,GAAG,gBAAgB,CAAC;IAC/B,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,yDAAyD;IACtE,OAAO,EAAE,eAAe;CACzB,CAAC,CAAC;AAEH,iEAAiE;AACjE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,WAAgB,EAAE,EAAE;IAC7C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAChC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;AACnC,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAElC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAU,EAAE,EAAE;IACpD,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/context-factory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared ServiceContext factory for REST API.
+ * Used by both MCP server (index.ts) and CLI (cli.ts).
+ */
+import type { ServiceContext } from './types.js';
+/**
+ * Build a ServiceContext from environment variables (lazy service initialization).
+ */
+export declare function createServiceContext(): ServiceContext;
+//# sourceMappingURL=context-factory.d.ts.map

package/build/context-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-factory.d.ts","sourceRoot":"","sources":["../src/context-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgGjD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAoBrD"}

package/build/context-factory.js

@@ -0,0 +1,108 @@
+/**
+ * Shared ServiceContext factory for REST API.
+ * Used by both MCP server (index.ts) and CLI (cli.ts).
+ */
+import { RestApiService } from './services/rest-api-service.js';
+/**
+ * Parse environment variables for custom headers (HEADER_* pattern)
+ */
+function getCustomHeadersFromEnv() {
+    const headers = {};
+    const headerPrefix = /^HEADER_/i;
+    for (const [key, value] of Object.entries(process.env)) {
+        if (headerPrefix.test(key) && value !== undefined) {
+            const headerName = key.replace(headerPrefix, "");
+            headers[headerName] = value;
+        }
+    }
+    return headers;
+}
+/**
+ * Build RestApiConfig from environment variables
+ */
+function buildConfigFromEnv() {
+    const baseUrl = process.env.REST_BASE_URL;
+    if (!baseUrl) {
+        throw new Error("REST_BASE_URL environment variable is required");
+    }
+    const config = {
+        baseUrl,
+        responseSizeLimit: process.env.REST_RESPONSE_SIZE_LIMIT
+            ? parseInt(process.env.REST_RESPONSE_SIZE_LIMIT, 10)
+            : 10000,
+        enableSslVerify: process.env.REST_ENABLE_SSL_VERIFY !== "false",
+        timeout: process.env.REST_TIMEOUT
+            ? parseInt(process.env.REST_TIMEOUT, 10)
+            : 30000,
+        customHeaders: getCustomHeadersFromEnv(),
+    };
+    // OAuth2 client credentials (highest priority)
+    if (process.env.OAUTH2_TOKEN_URL &&
+        process.env.OAUTH2_CLIENT_ID &&
+        process.env.OAUTH2_CLIENT_SECRET &&
+        process.env.OAUTH2_SCOPE) {
+        config.oauth2 = {
+            tokenUrl: process.env.OAUTH2_TOKEN_URL,
+            clientId: process.env.OAUTH2_CLIENT_ID,
+            clientSecret: process.env.OAUTH2_CLIENT_SECRET,
+            scope: process.env.OAUTH2_SCOPE,
+            grantType: process.env.OAUTH2_GRANT_TYPE || "client_credentials",
+        };
+        if (process.env.OAUTH2_ADDITIONAL_PARAMS) {
+            try {
+                config.oauth2.additionalParams = JSON.parse(process.env.OAUTH2_ADDITIONAL_PARAMS);
+            }
+            catch (e) {
+                console.error("Warning: OAUTH2_ADDITIONAL_PARAMS is not valid JSON");
+            }
+        }
+    }
+    // Static bearer token
+    else if (process.env.AUTH_BEARER) {
+        config.bearerToken = process.env.AUTH_BEARER;
+    }
+    // Basic auth
+    else if (process.env.AUTH_BASIC_USERNAME && process.env.AUTH_BASIC_PASSWORD) {
+        config.basicAuth = {
+            username: process.env.AUTH_BASIC_USERNAME,
+            password: process.env.AUTH_BASIC_PASSWORD,
+        };
+    }
+    // API key
+    else if (process.env.AUTH_APIKEY_HEADER_NAME &&
+        process.env.AUTH_APIKEY_VALUE) {
+        config.apiKey = {
+            headerName: process.env.AUTH_APIKEY_HEADER_NAME,
+            value: process.env.AUTH_APIKEY_VALUE,
+        };
+    }
+    // OpenAPI URL for dynamic discovery
+    if (process.env.REST_OPENAPI_URL) {
+        config.openApiUrl = process.env.REST_OPENAPI_URL;
+        console.error(`OpenAPI URL configured: ${config.openApiUrl}`);
+    }
+    return config;
+}
+/**
+ * Build a ServiceContext from environment variables (lazy service initialization).
+ */
+export function createServiceContext() {
+    let service = null;
+    function getService() {
+        if (!service) {
+            const config = buildConfigFromEnv();
+            service = new RestApiService(config);
+            console.error("REST API service initialized");
+            console.error(`  Base URL: ${config.baseUrl}`);
+            console.error(`  Auth method: ${service.getAuthMethod()}`);
+            if (config.oauth2) {
+                console.error(`  OAuth2 Token URL: ${config.oauth2.tokenUrl}`);
+            }
+        }
+        return service;
+    }
+    return {
+        get restApi() { return getService(); },
+    };
+}
+//# sourceMappingURL=context-factory.js.map

package/build/context-factory.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-consultant-tools/rest-api",
-  "version": "28.0.0-beta.7",
+  "version": "28.0.0",
   "description": "MCP server for REST API testing with OAuth2 client credentials support - test HTTP endpoints with automatic JWT token generation",
   "type": "module",
   "main": "./build/index.js",
@@ -45,8 +45,9 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@mcp-consultant-tools/core": "28.0.0-beta.7",
+    "@mcp-consultant-tools/core": "28.0.0",
     "@modelcontextprotocol/sdk": "^1.0.4",
+    "commander": "^14.0.3",
     "zod": "^3.24.1"
   },
   "devDependencies": {
@@ -54,6 +55,7 @@
     "typescript": "^5.8.2"
   },
   "bin": {
-    "mcp-rest-api": "build/index.js"
+    "mcp-rest-api": "build/index.js",
+    "mcp-rest-api-cli": "build/cli.js"
   }
 }