mcp4openapi 0.1.0

package/dist/mcp-server.js

@@ -0,0 +1,568 @@
+/**
+ * Main MCP server implementation
+ *
+ * Why: Coordinates OpenAPI parser, profile loader, tool generator, and request execution.
+ * Single entry point for tool registration and invocation.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { OpenAPIParser } from './openapi-parser.js';
+import { ProfileLoader } from './profile-loader.js';
+import { ToolGenerator } from './tool-generator.js';
+import { CompositeExecutor } from './composite-executor.js';
+import { InterceptorChain, HttpClient } from './interceptors.js';
+import { SchemaValidator } from './schema-validator.js';
+import { ConsoleLogger, JsonLogger } from './logger.js';
+export class MCPServer {
+    server;
+    parser;
+    profile;
+    toolGenerator;
+    httpClient;
+    compositeExecutor;
+    schemaValidator;
+    logger;
+    httpTransport = null;
+    sessionHttpClients = new Map();
+    /**
+     * Filter response object to include only specified fields
+     * Supports nested objects but keeps first level of arrays
+     */
+    filterFields(data, fields) {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        if (Array.isArray(data)) {
+            return data.map(item => this.filterFields(item, fields));
+        }
+        const filtered = {};
+        for (const field of fields) {
+            if (field in data) {
+                filtered[field] = data[field];
+            }
+        }
+        return filtered;
+    }
+    constructor(logger) {
+        this.logger = logger || new ConsoleLogger();
+        this.schemaValidator = new SchemaValidator();
+        this.server = new Server({
+            name: 'mcp-from-openapi',
+            version: '0.1.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.parser = new OpenAPIParser();
+        this.toolGenerator = new ToolGenerator(this.parser);
+        this.setupHandlers();
+    }
+    async initialize(specPath, profilePath) {
+        // Load OpenAPI spec
+        await this.parser.load(specPath);
+        this.logger.info('Loaded OpenAPI spec', { specPath });
+        // Load profile
+        if (profilePath) {
+            const loader = new ProfileLoader();
+            this.profile = await loader.load(profilePath);
+            this.logger.info('Loaded profile', {
+                profile: this.profile.profile_name,
+                toolCount: this.profile.tools.length,
+            });
+            // DEBUG: Check response_fields
+            const groupsTool = this.profile.tools.find(t => t.name === 'manage_groups');
+            this.logger.info('[DEBUG] manage_groups tool', {
+                hasResponseFields: !!groupsTool?.response_fields,
+                responseFields: groupsTool?.response_fields
+            });
+        }
+        else {
+            this.profile = ProfileLoader.createDefaultProfile('default');
+            this.logger.warn('Using default profile (no profile specified)');
+        }
+        // Re-create logger with auth config for token redaction
+        if (this.profile.interceptors?.auth) {
+            this.logger = this.createLoggerWithAuth(this.profile.interceptors.auth);
+            this.logger.info('Logger re-configured with auth token redaction');
+        }
+        // Setup HTTP client with interceptors
+        // For stdio transport, create client with env token
+        // For HTTP transport, clients are created per-session with user's token
+        const baseUrl = this.getBaseUrl();
+        if (this.profile.interceptors?.auth) {
+            const envToken = process.env[this.profile.interceptors.auth.value_from_env];
+            if (envToken) {
+                // Token available in env - create global client (stdio transport)
+                const interceptors = new InterceptorChain(this.profile.interceptors);
+                this.httpClient = new HttpClient(baseUrl, interceptors);
+                this.compositeExecutor = new CompositeExecutor(this.parser, this.httpClient);
+            }
+            else {
+                // No env token - will use per-session clients (HTTP transport)
+                this.compositeExecutor = new CompositeExecutor(this.parser);
+            }
+        }
+        else {
+            // No auth configured
+            const interceptors = new InterceptorChain(this.profile.interceptors || {});
+            this.httpClient = new HttpClient(baseUrl, interceptors);
+            this.compositeExecutor = new CompositeExecutor(this.parser, this.httpClient);
+        }
+        this.logger.info('MCP server initialized', {
+            baseUrl,
+            toolCount: this.profile.tools.length,
+        });
+    }
+    /**
+     * Create logger with auth configuration for token redaction
+     *
+     * Why: Prevents sensitive tokens from appearing in logs
+     */
+    createLoggerWithAuth(authConfig) {
+        const logFormat = process.env.LOG_FORMAT || 'console';
+        const logLevel = this.logger instanceof ConsoleLogger || this.logger instanceof JsonLogger
+            ? this.logger.level
+            : undefined;
+        return logFormat === 'json'
+            ? new JsonLogger(logLevel, authConfig)
+            : new ConsoleLogger(logLevel, authConfig);
+    }
+    /**
+     * Get base URL from profile config or OpenAPI spec
+     */
+    getBaseUrl() {
+        const baseUrlConfig = this.profile?.interceptors?.base_url;
+        if (baseUrlConfig) {
+            const envValue = process.env[baseUrlConfig.value_from_env];
+            if (envValue)
+                return envValue;
+            if (baseUrlConfig.default)
+                return baseUrlConfig.default;
+        }
+        return this.parser.getBaseUrl();
+    }
+    /**
+     * Get or create HTTP client for session
+     */
+    getHttpClientForSession(sessionId) {
+        if (!sessionId) {
+            // Fallback to global client for stdio transport
+            if (!this.httpClient) {
+                const hasHttpTransport = !!this.httpTransport;
+                const transport = hasHttpTransport ? 'http' : 'stdio';
+                const authConfig = this.profile?.interceptors?.auth;
+                const envVarName = authConfig?.value_from_env || 'API_TOKEN';
+                const hasEnvToken = !!process.env[envVarName];
+                throw new Error(`HTTP client not initialized. ` +
+                    `Transport: ${transport}, ` +
+                    `HasEnvToken(${envVarName}): ${hasEnvToken}, ` +
+                    `Suggestion: ${hasHttpTransport
+                        ? 'Send token in Authorization header during initialization'
+                        : `Set ${envVarName} environment variable`}`);
+            }
+            return this.httpClient;
+        }
+        // Check cache first
+        let client = this.sessionHttpClients.get(sessionId);
+        if (client) {
+            return client;
+        }
+        // Get auth token from session or env
+        const authToken = this.getAuthTokenFromSession(sessionId);
+        const envToken = this.profile?.interceptors?.auth
+            ? process.env[this.profile.interceptors.auth.value_from_env]
+            : undefined;
+        if (!authToken && !envToken) {
+            const authConfig = this.profile?.interceptors?.auth;
+            const expectedEnvVar = authConfig?.value_from_env || 'API_TOKEN';
+            throw new Error(`No auth token found for session ${sessionId}. ` +
+                `Expected token in Authorization/X-API-Token header or ${expectedEnvVar} env var`);
+        }
+        // Create new client with session-specific interceptor
+        if (!this.profile) {
+            throw new Error('Profile not initialized');
+        }
+        const baseUrl = this.getBaseUrl();
+        const tokenToUse = authToken || envToken;
+        const interceptors = new InterceptorChain(this.profile.interceptors || {}, tokenToUse);
+        const newClient = new HttpClient(baseUrl, interceptors);
+        // Double-check: Another concurrent request might have created client
+        // Race condition prevention: Use first client that was set
+        const existingClient = this.sessionHttpClients.get(sessionId);
+        if (existingClient) {
+            // Another request won the race, use its client
+            return existingClient;
+        }
+        // We won the race, cache our client
+        this.sessionHttpClients.set(sessionId, newClient);
+        return newClient;
+    }
+    /**
+     * Get auth token from HTTP transport session
+     */
+    getAuthTokenFromSession(sessionId) {
+        if (!this.httpTransport) {
+            return undefined;
+        }
+        // Use public API instead of type casting
+        return this.httpTransport.getSessionToken(sessionId);
+    }
+    /**
+     * Cleanup HTTP client for destroyed session
+     *
+     * Why: Prevent memory leak - sessions expire but cached clients stay forever
+     */
+    cleanupSessionClient(sessionId) {
+        const removed = this.sessionHttpClients.delete(sessionId);
+        if (removed) {
+            this.logger.info('Cleaned up session HTTP client', { sessionId });
+        }
+    }
+    /**
+     * Setup MCP request handlers
+     */
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            if (!this.profile) {
+                throw new Error('Server not initialized');
+            }
+            const tools = this.profile.tools.map(toolDef => this.toolGenerator.generateTool(toolDef));
+            return { tools };
+        });
+        // Execute tool
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            if (!this.profile || !this.httpClient || !this.compositeExecutor) {
+                throw new Error('Server not initialized');
+            }
+            const toolDef = this.profile.tools.find(t => t.name === request.params.name);
+            if (!toolDef) {
+                throw new Error(`Tool not found: ${request.params.name}`);
+            }
+            const args = request.params.arguments || {};
+            // Validate arguments
+            this.toolGenerator.validateArguments(toolDef, args);
+            // Execute composite or simple tool
+            let result;
+            if (toolDef.composite && toolDef.steps) {
+                const compositeResult = await this.compositeExecutor.execute(toolDef.steps, args, toolDef.partial_results || false);
+                // Include metadata about completion
+                result = {
+                    ...compositeResult.data,
+                    _metadata: {
+                        completed_steps: compositeResult.completed_steps,
+                        total_steps: compositeResult.total_steps,
+                        success: compositeResult.completed_steps === compositeResult.total_steps,
+                        errors: compositeResult.errors,
+                    },
+                };
+            }
+            else {
+                result = await this.executeSimpleTool(toolDef, args);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        });
+    }
+    /**
+     * Execute simple (non-composite) tool
+     *
+     * Why separate: Simple tools map directly to single OpenAPI operation.
+     * No result aggregation needed.
+     */
+    async executeSimpleTool(toolDef, args, sessionId) {
+        // DEBUG: Check if response_fields is present
+        this.logger.info('[DEBUG] executeSimpleTool', {
+            toolName: toolDef.name,
+            action: args.action,
+            hasResponseFields: !!toolDef.response_fields,
+            responseFields: toolDef.response_fields
+        });
+        const operationId = this.toolGenerator.mapActionToOperation(toolDef, args);
+        if (!operationId) {
+            throw new Error(`Could not map tool action to operation`);
+        }
+        const operation = this.parser.getOperation(operationId);
+        if (!operation) {
+            throw new Error(`Operation not found: ${operationId}`);
+        }
+        // Build request
+        const path = this.resolvePath(operation.path, args);
+        const queryParams = this.extractQueryParams(operation, args);
+        const body = this.extractBody(operation, args, toolDef);
+        // Validate request body against schema
+        if (body && operation.requestBody) {
+            const validationResult = this.schemaValidator.validateRequestBody(operation, body);
+            if (!validationResult.valid && validationResult.errors) {
+                const errorDetails = validationResult.errors
+                    .map(e => `  - ${e.path}: ${e.message}`)
+                    .join('\n');
+                throw new Error(`Request body validation failed:\n${errorDetails}`);
+            }
+        }
+        // Execute with session-specific client
+        const httpClient = this.getHttpClientForSession(sessionId);
+        const response = await httpClient.request(operation.method, path, {
+            params: queryParams,
+            body,
+        });
+        // Apply response field filtering if configured
+        let result = response.body;
+        if (toolDef.response_fields) {
+            const action = args.action;
+            if (action && toolDef.response_fields[action]) {
+                const fields = toolDef.response_fields[action];
+                result = this.filterFields(result, fields);
+            }
+        }
+        return result;
+    }
+    /**
+     * Resolve path parameters using profile aliases
+     *
+     * Why aliases: Different tools may use different parameter names for same path param.
+     * Example: GitLab uses "resource_id", "project_id", "group_id" all mapping to "{id}"
+     */
+    resolvePath(template, args) {
+        const aliases = this.profile?.parameter_aliases || {};
+        return template.replace(/\{(\w+)\}/g, (_, key) => {
+            // Try direct match first
+            if (args[key] !== undefined) {
+                return String(args[key]);
+            }
+            // Try aliases from profile
+            const possibleAliases = aliases[key] || [];
+            for (const alias of possibleAliases) {
+                if (args[alias] !== undefined) {
+                    return String(args[alias]);
+                }
+            }
+            throw new Error(`Missing path parameter: ${key}` +
+                (possibleAliases.length > 0 ? `. Tried aliases: ${possibleAliases.join(', ')}` : ''));
+        });
+    }
+    /**
+     * Extract query parameters from args
+     *
+     * Why: Separate query params from body params. Array handling is done by HttpClient
+     * based on profile's array_format setting.
+     */
+    extractQueryParams(operation, args) {
+        const params = {};
+        for (const param of operation.parameters) {
+            if (param.in === 'query' && args[param.name] !== undefined) {
+                const value = args[param.name];
+                // Pass arrays as-is, HttpClient will serialize based on array_format
+                if (Array.isArray(value)) {
+                    params[param.name] = value.map(String);
+                }
+                else {
+                    params[param.name] = String(value);
+                }
+            }
+        }
+        return params;
+    }
+    /**
+     * Extract request body from args
+     *
+     * Why: For create/update operations, collect non-metadata fields into body.
+     * Metadata (action, resource_type, etc.) are not sent to API.
+     * Path/query parameters are also excluded from body.
+     *
+     * Uses metadata_params from tool definition, defaults to ['action', 'resource_type']
+     */
+    extractBody(operation, args, toolDef) {
+        // Metadata fields from tool definition (or defaults)
+        const metadataList = toolDef.metadata_params || ['action', 'resource_type'];
+        const metadata = new Set(metadataList);
+        // Collect parameter names that go in path or query
+        const pathOrQuery = new Set();
+        for (const param of operation.parameters) {
+            if (param.in === 'path' || param.in === 'query') {
+                pathOrQuery.add(param.name);
+            }
+        }
+        const body = {};
+        let hasBody = false;
+        for (const [key, value] of Object.entries(args)) {
+            if (!metadata.has(key) && !pathOrQuery.has(key) && value !== undefined) {
+                body[key] = value;
+                hasBody = true;
+            }
+        }
+        return hasBody ? body : undefined;
+    }
+    /**
+     * Start server with stdio transport
+     */
+    async runStdio() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        this.logger.info('MCP server running on stdio');
+    }
+    /**
+     * Start server with HTTP transport
+     *
+     * Implements MCP Specification 2025-03-26 Streamable HTTP transport
+     *
+     * Why: Enables remote MCP server access with SSE streaming, session management,
+     * and resumability for reliable communication over HTTP.
+     */
+    async runHttp(host, port) {
+        const { HttpTransport } = await import('./http-transport.js');
+        const config = {
+            host,
+            port,
+            sessionTimeoutMs: parseInt(process.env.SESSION_TIMEOUT_MS || '1800000', 10),
+            heartbeatEnabled: process.env.HEARTBEAT_ENABLED === 'true',
+            heartbeatIntervalMs: parseInt(process.env.HEARTBEAT_INTERVAL_MS || '30000', 10),
+            metricsEnabled: process.env.METRICS_ENABLED === 'true',
+            metricsPath: process.env.METRICS_PATH || '/metrics',
+            allowedOrigins: process.env.ALLOWED_ORIGINS
+                ? process.env.ALLOWED_ORIGINS.split(',').map(o => o.trim())
+                : undefined,
+        };
+        this.httpTransport = new HttpTransport(config, this.logger);
+        // Set message handler to process JSON-RPC messages
+        this.httpTransport.setMessageHandler(async (message, sessionId) => {
+            return await this.handleJsonRpcMessage(message, sessionId);
+        });
+        // Register cleanup listener for session destruction (memory leak prevention)
+        this.httpTransport.onSessionDestroyed((sessionId) => {
+            this.cleanupSessionClient(sessionId);
+        });
+        await this.httpTransport.start();
+        this.logger.info('MCP server running on HTTP', { host, port });
+    }
+    /**
+     * Handle JSON-RPC message from HTTP transport
+     *
+     * Why: Unified message handling for both stdio and HTTP transports
+     */
+    async handleJsonRpcMessage(message, sessionId) {
+        // Handle initialize
+        if (this.isInitializeRequest(message)) {
+            return this.handleInitialize(message);
+        }
+        // Handle tool calls
+        if (this.isToolCallRequest(message)) {
+            return await this.handleToolCall(message, sessionId);
+        }
+        // Handle other JSON-RPC requests
+        // (tools/list, prompts/list, etc.)
+        return this.handleOtherRequest(message);
+    }
+    isInitializeRequest(message) {
+        if (typeof message !== 'object' || message === null)
+            return false;
+        const req = message;
+        return req.method === 'initialize';
+    }
+    isToolCallRequest(message) {
+        if (typeof message !== 'object' || message === null)
+            return false;
+        const req = message;
+        return req.method === 'tools/call';
+    }
+    handleInitialize(message) {
+        const req = message;
+        return {
+            jsonrpc: '2.0',
+            id: req.id,
+            result: {
+                protocolVersion: '2025-03-26',
+                serverInfo: {
+                    name: 'mcp-from-openapi',
+                    version: '0.1.0',
+                },
+                capabilities: {
+                    tools: {},
+                },
+            },
+        };
+    }
+    async handleToolCall(message, sessionId) {
+        const req = message;
+        const params = req.params;
+        const toolName = params.name;
+        const args = params.arguments;
+        try {
+            // Find tool definition
+            const toolDef = this.profile?.tools.find(t => t.name === toolName);
+            if (!toolDef) {
+                throw new Error(`Tool not found: ${toolName}`);
+            }
+            // Execute tool (reuse existing execution logic)
+            let result;
+            if (toolDef.composite && toolDef.steps) {
+                const httpClient = this.getHttpClientForSession(sessionId);
+                const compositeResult = await this.compositeExecutor.execute(toolDef.steps, args, toolDef.partial_results || false, httpClient);
+                result = {
+                    data: compositeResult.data,
+                    completed_steps: compositeResult.completed_steps,
+                    total_steps: compositeResult.total_steps,
+                    success: compositeResult.completed_steps === compositeResult.total_steps,
+                    errors: compositeResult.errors,
+                };
+            }
+            else {
+                result = await this.executeSimpleTool(toolDef, args, sessionId);
+            }
+            return {
+                jsonrpc: '2.0',
+                id: req.id,
+                result: {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                },
+            };
+        }
+        catch (error) {
+            return {
+                jsonrpc: '2.0',
+                id: req.id,
+                error: {
+                    code: -32603,
+                    message: error.message,
+                },
+            };
+        }
+    }
+    handleOtherRequest(message) {
+        const req = message;
+        // Handle tools/list
+        if (req.method === 'tools/list') {
+            const tools = this.profile?.tools.map(toolDef => this.toolGenerator.generateTool(toolDef)) || [];
+            return {
+                jsonrpc: '2.0',
+                id: req.id,
+                result: {
+                    tools,
+                },
+            };
+        }
+        // Unknown method
+        return {
+            jsonrpc: '2.0',
+            id: req.id,
+            error: {
+                code: -32601,
+                message: `Method not found: ${req.method}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Prometheus Metrics Collector
+ *
+ * Why: Observability for production deployments
+ *
+ * Tracks:
+ * - HTTP requests (status, method, path)
+ * - Session lifecycle (active, created, destroyed)
+ * - MCP operations (tool calls, duration, errors)
+ * - API calls to backend (operation, status, duration)
+ */
+import { Registry } from 'prom-client';
+export interface MetricsCollectorConfig {
+    enabled: boolean;
+    prefix?: string;
+}
+export declare class MetricsCollector {
+    private registry;
+    private enabled;
+    private httpRequestsTotal;
+    private httpRequestDuration;
+    private sessionsActive;
+    private sessionsCreatedTotal;
+    private sessionsDestroyedTotal;
+    private mcpToolCallsTotal;
+    private mcpToolCallDuration;
+    private mcpToolCallErrors;
+    private apiCallsTotal;
+    private apiCallDuration;
+    private apiCallErrors;
+    constructor(config: MetricsCollectorConfig);
+    /**
+     * Record HTTP request
+     */
+    recordHttpRequest(method: string, path: string, status: number, durationSeconds: number): void;
+    /**
+     * Record session created
+     */
+    recordSessionCreated(): void;
+    /**
+     * Record session destroyed
+     */
+    recordSessionDestroyed(): void;
+    /**
+     * Record MCP tool call
+     */
+    recordToolCall(tool: string, status: 'success' | 'error', durationSeconds: number): void;
+    /**
+     * Record MCP tool call error
+     */
+    recordToolCallError(tool: string, errorType: string): void;
+    /**
+     * Record API call to backend
+     */
+    recordApiCall(operation: string, status: number, durationSeconds: number): void;
+    /**
+     * Record API call error
+     */
+    recordApiCallError(operation: string, errorType: string): void;
+    /**
+     * Get metrics in Prometheus format
+     */
+    getMetrics(): Promise<string>;
+    /**
+     * Get registry (for testing)
+     */
+    getRegistry(): Registry;
+    /**
+     * Normalize path for metrics (remove dynamic segments)
+     *
+     * Why: Avoid high cardinality in metrics labels
+     *
+     * Examples:
+     * - /mcp?sessionId=abc123 -> /mcp
+     * - /metrics -> /metrics
+     * - /health -> /health
+     */
+    private normalizePath;
+    /**
+     * Get status label (2xx, 4xx, 5xx)
+     *
+     * Why: Group similar statuses to reduce cardinality
+     */
+    private getStatusLabel;
+}
+//# sourceMappingURL=metrics.d.ts.map