@machina.ai/openapi-contract-tester 2.1.0

package/dist/mcp/server.js

@@ -0,0 +1,200 @@
+/**
+ * MCP Server Implementation
+ *
+ * Model Context Protocol server for OpenAPI contract testing.
+ * Provides tools for test generation, execution, and contract validation
+ * via STDIO transport for MCP client integration.
+ *
+ * This server uses a handler registry pattern for clean separation of concerns.
+ *
+ * @module mcp/server
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// Services
+import { SpecService } from './services/spec-service.js';
+import { ReportService } from './services/report-service.js';
+import { FileService } from './services/file-service.js';
+import { PostmanService } from './services/postman-service.js';
+// Handlers
+import { GenerateTestsHandler, RunTestsHandler, ExportResultsHandler, CompareSourcesHandler, ExportToPostmanHandler } from './handlers/index.js';
+// Utils
+import { createLogger } from '../utils/logger.js';
+import { MCPError, ErrorCode } from '../utils/errors.js';
+const log = createLogger('mcp-server');
+/**
+ * OpenAPI Contract Tester MCP Server
+ *
+ * Provides 5 essential tools for API testing:
+ * 1. generate-tests - Generate intelligent test suites from OpenAPI specs (AI-powered)
+ * 2. run-tests - Execute test suites against APIs with auto-repair
+ * 3. export-results - Export test results with AI analysis and coverage
+ * 4. compare-sources - Compare OpenAPI vs Code vs PRD
+ * 5. export-to-postman - Export tests as Postman Collection v2.1 (Newman compatible)
+ *
+ * Architecture:
+ * - Uses Strategy pattern for tool handlers
+ * - Each handler implements ToolHandler interface
+ * - Services provide shared functionality (spec parsing, LLM calls, reporting, file I/O)
+ * - Handler registry enables clean dispatch and extensibility
+ */
+export class OpenAPIContractTesterServer {
+    server;
+    handlers;
+    // Shared services
+    specService;
+    reportService;
+    fileService;
+    postmanService;
+    constructor() {
+        // Initialize MCP server
+        this.server = new Server({
+            name: 'openapi-contract-tester',
+            version: '2.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        // Initialize services
+        this.specService = new SpecService();
+        this.reportService = new ReportService();
+        this.fileService = new FileService();
+        this.postmanService = new PostmanService();
+        // Initialize handler registry
+        this.handlers = new Map();
+        this.registerHandlers();
+        // Setup MCP request handlers
+        this.setupHandlers();
+        log.info('MCP Server initialized', {
+            handlers: Array.from(this.handlers.keys()),
+            version: '2.0.0'
+        });
+    }
+    /**
+     * Registers all tool handlers
+     * @private
+     */
+    registerHandlers() {
+        // Create handler instances with dependencies
+        const generateTestsHandler = new GenerateTestsHandler(this.specService);
+        const runTestsHandler = new RunTestsHandler(this.specService);
+        const exportResultsHandler = new ExportResultsHandler(this.reportService, this.fileService);
+        const compareSourcesHandler = new CompareSourcesHandler(this.specService, this.fileService);
+        const exportToPostmanHandler = new ExportToPostmanHandler(this.postmanService, this.fileService);
+        // Register handlers in registry
+        this.handlers.set(generateTestsHandler.name, generateTestsHandler);
+        this.handlers.set(runTestsHandler.name, runTestsHandler);
+        this.handlers.set(exportResultsHandler.name, exportResultsHandler);
+        this.handlers.set(compareSourcesHandler.name, compareSourcesHandler);
+        this.handlers.set(exportToPostmanHandler.name, exportToPostmanHandler);
+        log.info('Handlers registered', {
+            count: this.handlers.size,
+            names: Array.from(this.handlers.keys())
+        });
+    }
+    /**
+     * Sets up MCP request handlers
+     * @private
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            const tools = Array.from(this.handlers.values()).map(handler => ({
+                name: handler.name,
+                description: handler.description,
+                inputSchema: handler.inputSchema
+            }));
+            log.debug('ListTools request', { toolCount: tools.length });
+            return { tools };
+        });
+        // Handle tool calls via registry
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const toolName = request.params.name;
+            log.info('Tool call received', {
+                tool: toolName,
+                hasArguments: !!request.params.arguments
+            });
+            // Look up handler in registry
+            const handler = this.handlers.get(toolName);
+            if (!handler) {
+                const availableTools = Array.from(this.handlers.keys()).join(', ');
+                const errorMessage = `Unknown tool: ${toolName}. Available tools: ${availableTools}`;
+                log.error('Tool not found', {
+                    requestedTool: toolName,
+                    availableTools: Array.from(this.handlers.keys())
+                });
+                throw new MCPError(ErrorCode.MCP_INVALID_ARGUMENTS, errorMessage, `Tool '${toolName}' is not registered`);
+            }
+            try {
+                // Delegate to handler
+                const response = await handler.handle(request.params.arguments);
+                log.info('Tool call completed successfully', {
+                    tool: toolName,
+                    isError: response.isError || false
+                });
+                // Return response compatible with MCP SDK
+                return {
+                    content: response.content
+                };
+            }
+            catch (error) {
+                log.error('Tool call failed', {
+                    tool: toolName,
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                // Re-throw to let MCP SDK handle it
+                throw error;
+            }
+        });
+        log.info('MCP request handlers configured');
+    }
+    /**
+     * Starts the MCP server
+     */
+    async run() {
+        try {
+            log.info('Starting MCP server', { mode: 'stdio', version: '2.0.0' });
+            const transport = new StdioServerTransport();
+            await this.server.connect(transport);
+            // Only log to stderr (safe for STDIO protocol)
+            console.error('OpenAPI Contract Tester MCP Server v2.0.0 running on stdio');
+            log.info('MCP server started successfully', {
+                handlers: Array.from(this.handlers.keys())
+            });
+        }
+        catch (error) {
+            log.error('Failed to start MCP server', { error });
+            throw error;
+        }
+    }
+    /**
+     * Stops the MCP server gracefully
+     */
+    async stop() {
+        try {
+            log.info('Stopping MCP server');
+            await this.server.close();
+            log.info('MCP server stopped successfully');
+        }
+        catch (error) {
+            log.error('Error stopping MCP server', { error });
+            throw error;
+        }
+    }
+    /**
+     * Gets the list of registered handlers (for testing/debugging)
+     */
+    getHandlers() {
+        return this.handlers;
+    }
+}
+/**
+ * Creates and starts the MCP server
+ */
+export async function startMCPServer() {
+    const server = new OpenAPIContractTesterServer();
+    await server.run();
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/services/file-service.d.ts

@@ -0,0 +1,66 @@
+/**
+ * File Service - Centralized file I/O operations
+ *
+ * Handles all file system operations for the MCP server including:
+ * - Path resolution
+ * - Test data loading
+ * - PRD loading
+ * - File saving
+ *
+ * @module mcp/services/file-service
+ */
+import { type NormalizedPrd } from '../../prd/prd-storage.js';
+/**
+ * Service for centralized file operations
+ */
+export declare class FileService {
+    /**
+     * Resolves a file path (absolute, relative, or with ~)
+     *
+     * @param filePath - Path to resolve
+     * @param workingDirectory - Optional working directory for relative paths
+     * @returns Resolved absolute path
+     */
+    resolveFilePath(filePath: string, workingDirectory?: string): string;
+    /**
+     * Loads test data from a JSON file
+     *
+     * @param filePath - Path to JSON test data file
+     * @param workingDirectory - Optional working directory
+     * @returns Parsed test data object
+     */
+    loadTestData(filePath: string, workingDirectory?: string): Promise<Record<string, unknown>>;
+    /**
+     * Loads PRD (Product Requirements Document) from various formats
+     *
+     * @param source - File path, directory, or URL to PRD
+     * @param workingDirectory - Optional working directory
+     * @returns Normalized PRD object
+     */
+    loadPrd(source: string, workingDirectory?: string): Promise<NormalizedPrd>;
+    /**
+     * Saves content to a file
+     *
+     * @param filePath - Path where to save the file
+     * @param content - Content to write
+     * @param workingDirectory - Optional working directory
+     */
+    saveFile(filePath: string, content: string, workingDirectory?: string): Promise<void>;
+    /**
+     * Checks if a file exists
+     *
+     * @param filePath - Path to check
+     * @param workingDirectory - Optional working directory
+     * @returns True if file exists
+     */
+    fileExists(filePath: string, workingDirectory?: string): Promise<boolean>;
+    /**
+     * Reads a file as string
+     *
+     * @param filePath - Path to file
+     * @param workingDirectory - Optional working directory
+     * @returns File contents as string
+     */
+    readFile(filePath: string, workingDirectory?: string): Promise<string>;
+}
+//# sourceMappingURL=file-service.d.ts.map

package/dist/mcp/services/file-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/file-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKvE;;GAEG;AACH,qBAAa,WAAW;IACtB;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAOpE;;;;;;OAMG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiBjG;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiBhF;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3F;;;;;;OAMG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/E;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAa7E"}

package/dist/mcp/services/file-service.js

@@ -0,0 +1,143 @@
+/**
+ * File Service - Centralized file I/O operations
+ *
+ * Handles all file system operations for the MCP server including:
+ * - Path resolution
+ * - Test data loading
+ * - PRD loading
+ * - File saving
+ *
+ * @module mcp/services/file-service
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { resolveFilePath } from '../../utils/path-resolver.js';
+import { loadTestData } from '../../utils/data-loader.js';
+import { loadPrd } from '../../prd/prd-storage.js';
+import { createLogger } from '../../utils/logger.js';
+const log = createLogger('file-service');
+/**
+ * Service for centralized file operations
+ */
+export class FileService {
+    /**
+     * Resolves a file path (absolute, relative, or with ~)
+     *
+     * @param filePath - Path to resolve
+     * @param workingDirectory - Optional working directory for relative paths
+     * @returns Resolved absolute path
+     */
+    resolveFilePath(filePath, workingDirectory) {
+        log.debug('Resolving file path', { filePath, workingDirectory });
+        const resolved = resolveFilePath(filePath, workingDirectory);
+        log.debug('Path resolved', { original: filePath, resolved });
+        return resolved;
+    }
+    /**
+     * Loads test data from a JSON file
+     *
+     * @param filePath - Path to JSON test data file
+     * @param workingDirectory - Optional working directory
+     * @returns Parsed test data object
+     */
+    async loadTestData(filePath, workingDirectory) {
+        const resolvedPath = this.resolveFilePath(filePath, workingDirectory);
+        log.info('Loading test data', { path: resolvedPath });
+        try {
+            const data = await loadTestData(resolvedPath);
+            log.info('Test data loaded successfully', {
+                path: resolvedPath,
+                keys: Object.keys(data)
+            });
+            return data;
+        }
+        catch (error) {
+            log.error('Failed to load test data', { path: resolvedPath, error });
+            throw new Error(`Failed to load test data from ${resolvedPath}: ${error}`);
+        }
+    }
+    /**
+     * Loads PRD (Product Requirements Document) from various formats
+     *
+     * @param source - File path, directory, or URL to PRD
+     * @param workingDirectory - Optional working directory
+     * @returns Normalized PRD object
+     */
+    async loadPrd(source, workingDirectory) {
+        const resolvedPath = this.resolveFilePath(source, workingDirectory);
+        log.info('Loading PRD', { path: resolvedPath });
+        try {
+            const prd = await loadPrd(resolvedPath);
+            log.info('PRD loaded successfully', {
+                path: resolvedPath,
+                userStories: prd.userStories?.length || 0
+            });
+            return prd;
+        }
+        catch (error) {
+            log.error('Failed to load PRD', { path: resolvedPath, error });
+            throw new Error(`Failed to load PRD from ${resolvedPath}: ${error}`);
+        }
+    }
+    /**
+     * Saves content to a file
+     *
+     * @param filePath - Path where to save the file
+     * @param content - Content to write
+     * @param workingDirectory - Optional working directory
+     */
+    async saveFile(filePath, content, workingDirectory) {
+        const resolvedPath = this.resolveFilePath(filePath, workingDirectory);
+        log.info('Saving file', { path: resolvedPath, size: content.length });
+        try {
+            // Create directory if it doesn't exist
+            const dir = path.dirname(resolvedPath);
+            await fs.mkdir(dir, { recursive: true });
+            // Write file
+            await fs.writeFile(resolvedPath, content, 'utf-8');
+            log.info('File saved successfully', { path: resolvedPath });
+        }
+        catch (error) {
+            log.error('Failed to save file', { path: resolvedPath, error });
+            throw new Error(`Failed to save file to ${resolvedPath}: ${error}`);
+        }
+    }
+    /**
+     * Checks if a file exists
+     *
+     * @param filePath - Path to check
+     * @param workingDirectory - Optional working directory
+     * @returns True if file exists
+     */
+    async fileExists(filePath, workingDirectory) {
+        const resolvedPath = this.resolveFilePath(filePath, workingDirectory);
+        try {
+            await fs.access(resolvedPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Reads a file as string
+     *
+     * @param filePath - Path to file
+     * @param workingDirectory - Optional working directory
+     * @returns File contents as string
+     */
+    async readFile(filePath, workingDirectory) {
+        const resolvedPath = this.resolveFilePath(filePath, workingDirectory);
+        log.debug('Reading file', { path: resolvedPath });
+        try {
+            const content = await fs.readFile(resolvedPath, 'utf-8');
+            log.debug('File read successfully', { path: resolvedPath, size: content.length });
+            return content;
+        }
+        catch (error) {
+            log.error('Failed to read file', { path: resolvedPath, error });
+            throw new Error(`Failed to read file ${resolvedPath}: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=file-service.js.map

package/dist/mcp/services/file-service.js.map

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

package/dist/mcp/services/llm-service.d.ts

@@ -0,0 +1,70 @@
+/**
+ * LLM Service - AI/LLM operations
+ *
+ * Centralizes all LLM interactions including:
+ * - Calling AI for test generation
+ * - TOON format conversion
+ * - Prompt construction
+ *
+ * @module mcp/services/llm-service
+ */
+/**
+ * Service for LLM operations
+ */
+export declare class LLMService {
+    /**
+     * Calls the LLM with a prompt
+     *
+     * @param prompt - Prompt text to send to LLM
+     * @param options - Optional configuration
+     * @returns LLM response text
+     */
+    callLLM(prompt: string, options?: {
+        model?: string;
+        temperature?: number;
+    }): Promise<string>;
+    /**
+     * Formats data as TOON (Tree Object Oriented Notation)
+     *
+     * @param data - Data to format
+     * @returns TOON formatted string
+     */
+    formatAsTOON(data: unknown): string;
+    /**
+     * Parses TOON formatted text back to data
+     *
+     * @param text - TOON formatted text
+     * @returns Parsed data
+     */
+    parseTOONResponse(text: string): unknown;
+    /**
+     * Converts data to TOON format for AI consumption
+     *
+     * Uses toTOONFormat from ai-client which handles special formatting
+     * for AI prompts.
+     *
+     * @param data - Data to convert
+     * @returns TOON formatted string for AI
+     */
+    toTOONFormatForAI(data: unknown): string;
+    /**
+     * Constructs a prompt for test generation
+     *
+     * @param params - Parameters for prompt construction
+     * @returns Constructed prompt
+     */
+    constructTestGenerationPrompt(params: {
+        endpoints: unknown[];
+        userStories?: string;
+        apiContext?: unknown;
+        categories?: string[];
+    }): string;
+    /**
+     * Constructs a prompt for failure analysis
+     *
+     * @param failedTests - Failed test results
+     * @returns Constructed prompt
+     */
+    constructFailureAnalysisPrompt(failedTests: unknown[]): string;
+}
+//# sourceMappingURL=llm-service.d.ts.map

package/dist/mcp/services/llm-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-service.d.ts","sourceRoot":"","sources":["../../../src/mcp/services/llm-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;GAEG;AACH,qBAAa,UAAU;IACrB;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBlG;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAenC;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAexC;;;;;;;;OAQG;IACH,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM;IAexC;;;;;OAKG;IACH,6BAA6B,CAAC,MAAM,EAAE;QACpC,SAAS,EAAE,OAAO,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,GAAG,MAAM;IA2DV;;;;;OAKG;IACH,8BAA8B,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM;CAqB/D"}