@mcpmake/core 0.2.0

package/dist/parser/openapi-loader.js

@@ -0,0 +1,309 @@
+import SwaggerParser from '@apidevtools/swagger-parser';
+import { logger } from '../utils/logger.js';
+/**
+ * Detects if a parsed document is Swagger 2.0 and converts it to OpenAPI 3.0.
+ */
+function isSwagger2(doc) {
+    return typeof doc.swagger === 'string' && doc.swagger.startsWith('2.');
+}
+function convertSwagger2ToOpenApi3(doc) {
+    logger.warn('Converting Swagger 2.0 to OpenAPI 3.0');
+    const scheme = doc.schemes?.[0] ?? 'https';
+    const host = doc.host ?? 'localhost';
+    const basePath = doc.basePath ?? '/';
+    const serverUrl = `${scheme}://${host}${basePath === '/' ? '' : basePath}`;
+    const globalConsumes = doc.consumes ?? ['application/json'];
+    const globalProduces = doc.produces ?? ['application/json'];
+    const components = {};
+    // Map definitions -> components.schemas
+    if (doc.definitions) {
+        components.schemas = doc.definitions;
+    }
+    // Map parameters -> components.parameters
+    if (doc.parameters) {
+        components.parameters = convertParameterDefinitions(doc.parameters);
+    }
+    // Map securityDefinitions -> components.securitySchemes
+    if (doc.securityDefinitions) {
+        components.securitySchemes = convertSecurityDefinitions(doc.securityDefinitions);
+    }
+    // Convert paths
+    const convertedPaths = {};
+    if (doc.paths) {
+        for (const [path, pathItem] of Object.entries(doc.paths)) {
+            convertedPaths[path] = convertPathItem(pathItem, globalConsumes, globalProduces);
+        }
+    }
+    const result = {
+        openapi: '3.0.0',
+        info: doc.info,
+        servers: [{ url: serverUrl }],
+        paths: convertedPaths,
+    };
+    if (Object.keys(components).length > 0) {
+        result.components = components;
+    }
+    if (doc.security) {
+        result.security = doc.security;
+    }
+    if (doc.tags) {
+        result.tags = doc.tags;
+    }
+    if (doc.externalDocs) {
+        result.externalDocs = doc.externalDocs;
+    }
+    return result;
+}
+function convertPathItem(pathItem, globalConsumes, globalProduces) {
+    const methods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+    const result = {};
+    // Preserve path-level parameters
+    if (pathItem.parameters) {
+        result.parameters = convertParameters(pathItem.parameters);
+    }
+    for (const method of methods) {
+        const operation = pathItem[method];
+        if (!operation)
+            continue;
+        result[method] = convertOperation(operation, globalConsumes, globalProduces);
+    }
+    return result;
+}
+function convertOperation(operation, globalConsumes, globalProduces) {
+    const consumes = operation.consumes ?? globalConsumes;
+    const produces = operation.produces ?? globalProduces;
+    const converted = {};
+    // Copy simple fields
+    for (const key of ['operationId', 'summary', 'description', 'tags', 'deprecated', 'security']) {
+        if (operation[key] !== undefined) {
+            converted[key] = operation[key];
+        }
+    }
+    // Copy x- extension fields
+    for (const key of Object.keys(operation)) {
+        if (key.startsWith('x-')) {
+            converted[key] = operation[key];
+        }
+    }
+    // Separate body/formData params from regular params
+    const params = (operation.parameters ?? []);
+    const regularParams = [];
+    let bodyParam;
+    const formDataParams = [];
+    for (const p of params) {
+        if (p.in === 'body') {
+            bodyParam = p;
+        }
+        else if (p.in === 'formData') {
+            formDataParams.push(p);
+        }
+        else {
+            regularParams.push(p);
+        }
+    }
+    if (regularParams.length > 0) {
+        converted.parameters = convertParameters(regularParams);
+    }
+    // Build requestBody from body param or formData params
+    if (bodyParam) {
+        const contentType = consumes[0] ?? 'application/json';
+        converted.requestBody = {
+            description: bodyParam.description,
+            required: bodyParam.required ?? false,
+            content: {
+                [contentType]: {
+                    schema: convertSchemaRef(bodyParam.schema),
+                },
+            },
+        };
+    }
+    else if (formDataParams.length > 0) {
+        const hasFile = formDataParams.some((p) => p.type === 'file');
+        const contentType = hasFile ? 'multipart/form-data' : 'application/x-www-form-urlencoded';
+        const properties = {};
+        const required = [];
+        for (const p of formDataParams) {
+            const name = p.name;
+            if (p.type === 'file') {
+                properties[name] = { type: 'string', format: 'binary' };
+            }
+            else {
+                properties[name] = { type: p.type ?? 'string' };
+                if (p.description) {
+                    properties[name].description = p.description;
+                }
+            }
+            if (p.required) {
+                required.push(name);
+            }
+        }
+        converted.requestBody = {
+            content: {
+                [contentType]: {
+                    schema: {
+                        type: 'object',
+                        properties,
+                        ...(required.length > 0 ? { required } : {}),
+                    },
+                },
+            },
+        };
+    }
+    // Convert responses
+    const responses = (operation.responses ?? {});
+    const convertedResponses = {};
+    for (const [status, response] of Object.entries(responses)) {
+        const convertedResponse = {
+            description: response.description ?? '',
+        };
+        if (response.schema) {
+            const contentType = produces[0] ?? 'application/json';
+            convertedResponse.content = {
+                [contentType]: {
+                    schema: convertSchemaRef(response.schema),
+                },
+            };
+        }
+        if (response.headers) {
+            convertedResponse.headers = response.headers;
+        }
+        convertedResponses[status] = convertedResponse;
+    }
+    converted.responses = convertedResponses;
+    return converted;
+}
+function convertParameters(params) {
+    return params.map((p) => {
+        const converted = {
+            name: p.name,
+            in: p.in,
+        };
+        if (p.required !== undefined)
+            converted.required = p.required;
+        if (p.description !== undefined)
+            converted.description = p.description;
+        // Build schema from Swagger 2.0 parameter type fields
+        const schema = {};
+        if (p.type)
+            schema.type = p.type;
+        if (p.format)
+            schema.format = p.format;
+        if (p.enum)
+            schema.enum = p.enum;
+        if (p.default !== undefined)
+            schema.default = p.default;
+        if (p.items)
+            schema.items = p.items;
+        if (p.minimum !== undefined)
+            schema.minimum = p.minimum;
+        if (p.maximum !== undefined)
+            schema.maximum = p.maximum;
+        converted.schema = Object.keys(schema).length > 0 ? schema : { type: 'string' };
+        return converted;
+    });
+}
+function convertParameterDefinitions(params) {
+    const result = {};
+    for (const [name, param] of Object.entries(params)) {
+        const p = param;
+        if (p.in === 'body') {
+            // Body parameters in definitions are unusual; skip them for components.parameters
+            continue;
+        }
+        const converted = {
+            name: p.name ?? name,
+            in: p.in,
+        };
+        if (p.required !== undefined)
+            converted.required = p.required;
+        if (p.description !== undefined)
+            converted.description = p.description;
+        const schema = {};
+        if (p.type)
+            schema.type = p.type;
+        if (p.format)
+            schema.format = p.format;
+        if (p.enum)
+            schema.enum = p.enum;
+        converted.schema = Object.keys(schema).length > 0 ? schema : { type: 'string' };
+        result[name] = converted;
+    }
+    return result;
+}
+function convertSecurityDefinitions(defs) {
+    const result = {};
+    for (const [name, def] of Object.entries(defs)) {
+        const d = def;
+        switch (d.type) {
+            case 'basic':
+                result[name] = { type: 'http', scheme: 'basic' };
+                break;
+            case 'apiKey':
+                result[name] = { type: 'apiKey', name: d.name, in: d.in };
+                break;
+            case 'oauth2': {
+                const scheme = { type: 'oauth2', flows: {} };
+                const flows = scheme.flows;
+                const scopes = (d.scopes ?? {});
+                switch (d.flow) {
+                    case 'implicit':
+                        flows.implicit = { authorizationUrl: d.authorizationUrl, scopes };
+                        break;
+                    case 'password':
+                        flows.password = { tokenUrl: d.tokenUrl, scopes };
+                        break;
+                    case 'application':
+                        flows.clientCredentials = { tokenUrl: d.tokenUrl, scopes };
+                        break;
+                    case 'accessCode':
+                        flows.authorizationCode = {
+                            authorizationUrl: d.authorizationUrl,
+                            tokenUrl: d.tokenUrl,
+                            scopes,
+                        };
+                        break;
+                }
+                result[name] = scheme;
+                break;
+            }
+            default:
+                result[name] = d;
+        }
+    }
+    return result;
+}
+function convertSchemaRef(schema) {
+    if (!schema)
+        return {};
+    // Swagger 2.0 uses #/definitions/Foo, OpenAPI 3.0 uses #/components/schemas/Foo
+    // Since we move definitions -> components.schemas, update $ref paths
+    const result = {};
+    for (const [key, value] of Object.entries(schema)) {
+        if (key === '$ref' && typeof value === 'string') {
+            result.$ref = value.replace('#/definitions/', '#/components/schemas/');
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            result[key] = convertSchemaRef(value);
+        }
+        else if (Array.isArray(value)) {
+            result[key] = value.map((item) => typeof item === 'object' && item !== null
+                ? convertSchemaRef(item)
+                : item);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+export async function loadOpenApiSpec(input) {
+    // First, parse without dereferencing to check for Swagger 2.0
+    const raw = (await SwaggerParser.parse(input));
+    let specToParse = input;
+    if (isSwagger2(raw)) {
+        specToParse = convertSwagger2ToOpenApi3(raw);
+    }
+    const api = (await SwaggerParser.dereference(specToParse));
+    return { api, specPath: input };
+}
+//# sourceMappingURL=openapi-loader.js.map

package/dist/parser/openapi-loader.js.map

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

package/dist/parser/operation-extractor.d.ts

@@ -0,0 +1,14 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { OperationDescriptor } from '../types/index.js';
+export interface ExtractionResult {
+    operations: OperationDescriptor[];
+    baseUrl: string;
+    securitySchemes: Record<string, OpenAPIV3.SecuritySchemeObject>;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+}
+export declare function extractOperations(api: OpenAPIV3.Document): ExtractionResult;
+//# sourceMappingURL=operation-extractor.d.ts.map

package/dist/parser/operation-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-extractor.d.ts","sourceRoot":"","sources":["../../src/parser/operation-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EACV,mBAAmB,EAQpB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAChE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,CAAC,QAAQ,GAAG,gBAAgB,CAsD3E"}

package/dist/parser/operation-extractor.js

@@ -0,0 +1,156 @@
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+export function extractOperations(api) {
+    const operations = [];
+    const baseUrl = api.servers?.[0]?.url ?? '';
+    const securitySchemes = (api.components?.securitySchemes ?? {});
+    const globalSecurity = api.security ?? [];
+    for (const [path, pathItem] of Object.entries(api.paths ?? {})) {
+        if (!pathItem)
+            continue;
+        const item = pathItem;
+        const pathParams = (item.parameters ?? []);
+        for (const method of HTTP_METHODS) {
+            const operation = item[method];
+            if (!operation)
+                continue;
+            const opParams = (operation.parameters ?? []);
+            const mergedParams = mergeParameters(pathParams, opParams);
+            const operationId = operation.operationId ?? synthesizeOperationId(method, path);
+            const mcpExtensions = extractMcpExtensions(operation);
+            operations.push({
+                operationId,
+                method,
+                path,
+                summary: operation.summary,
+                description: operation.description,
+                tags: operation.tags ?? [],
+                parameters: mergedParams.map(toParameterDescriptor),
+                requestBody: extractRequestBody(operation.requestBody),
+                responses: extractResponses(operation.responses),
+                security: extractSecurity(operation.security ?? globalSecurity),
+                deprecated: operation.deprecated ?? false,
+                mcpExtensions,
+            });
+        }
+    }
+    return {
+        operations,
+        baseUrl,
+        securitySchemes,
+        info: {
+            title: api.info.title,
+            version: api.info.version,
+            description: api.info.description,
+        },
+    };
+}
+function mergeParameters(pathLevel, opLevel) {
+    const byKey = new Map();
+    for (const p of pathLevel)
+        byKey.set(`${p.in}:${p.name}`, p);
+    for (const p of opLevel)
+        byKey.set(`${p.in}:${p.name}`, p); // op-level overrides
+    return [...byKey.values()];
+}
+function toParameterDescriptor(p) {
+    return {
+        name: p.name,
+        in: p.in,
+        required: p.required ?? p.in === 'path',
+        description: p.description,
+        schema: (p.schema ?? { type: 'string' }),
+    };
+}
+function extractRequestBody(body) {
+    if (!body?.content)
+        return undefined;
+    const preferredTypes = [
+        'application/json',
+        'application/x-www-form-urlencoded',
+        'multipart/form-data',
+    ];
+    let contentType;
+    for (const ct of preferredTypes) {
+        if (body.content[ct]) {
+            contentType = ct;
+            break;
+        }
+    }
+    if (!contentType) {
+        contentType = Object.keys(body.content)[0];
+    }
+    if (!contentType)
+        return undefined;
+    const mediaType = body.content[contentType];
+    return {
+        required: body.required ?? false,
+        description: body.description,
+        contentType,
+        schema: (mediaType.schema ?? {}),
+    };
+}
+function extractResponses(responses) {
+    const result = [];
+    for (const [statusCode, responseObj] of Object.entries(responses)) {
+        const response = responseObj;
+        let contentType;
+        let schema;
+        if (response.content) {
+            contentType = Object.keys(response.content)[0];
+            if (contentType) {
+                schema = response.content[contentType].schema;
+            }
+        }
+        result.push({
+            statusCode,
+            description: response.description,
+            contentType,
+            schema,
+        });
+    }
+    return result;
+}
+function extractSecurity(security) {
+    const result = [];
+    for (const req of security) {
+        for (const [schemeName, scopes] of Object.entries(req)) {
+            result.push({ schemeName, scopes });
+        }
+    }
+    return result;
+}
+function synthesizeOperationId(method, path) {
+    const cleaned = path.replace(/[{}]/g, '').replace(/\//g, '_').replace(/^_/, '').replace(/_$/, '');
+    return `${method}_${cleaned}`;
+}
+function extractMcpExtensions(operation) {
+    const name = operation['x-mcp-name'];
+    const description = operation['x-mcp-description'];
+    const emit = operation['x-mcp-emit'];
+    const scope = operation['x-mcp-scope'];
+    const deprecationMessage = operation['x-mcp-deprecation-message'];
+    const deprecationReplacement = operation['x-mcp-deprecation-replacement'];
+    const jqFilter = operation['x-mcp-jq-filter'];
+    const unknownValues = operation['x-mcp-unknown-values'];
+    if (!name &&
+        !description &&
+        !emit &&
+        !scope &&
+        !deprecationMessage &&
+        !deprecationReplacement &&
+        !jqFilter &&
+        !unknownValues) {
+        return undefined;
+    }
+    return {
+        name,
+        description,
+        emit,
+        scope,
+        deprecationMessage,
+        deprecationReplacement,
+        jqFilter,
+        unknownValues,
+    };
+}
+//# sourceMappingURL=operation-extractor.js.map

package/dist/parser/operation-extractor.js.map

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

package/dist/parser/overlay-loader.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Applies an OpenAPI Overlay document to a spec, modifying it in place.
+ *
+ * Supports simplified JSONPath-like targets:
+ * - `$.paths['/users'].get`       exact path + method
+ * - `$.paths['/users'].get.x-foo` exact nested field
+ * - `$.paths['/admin/*']`         wildcard match on path prefix
+ * - `$.components.schemas.User`   schema-level targeting
+ */
+export declare function applyOverlay(spec: Record<string, unknown>, overlayPath: string): Promise<void>;
+//# sourceMappingURL=overlay-loader.d.ts.map

package/dist/parser/overlay-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-loader.d.ts","sourceRoot":"","sources":["../../src/parser/overlay-loader.ts"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CASf"}