mcp-openapi 0.1.0

package/dist/src/generator/param-builder.js

@@ -0,0 +1,110 @@
+/**
+ * Flatten path, query, header, and body parameters into a single
+ * MCP tool inputSchema. Handles name collisions with prefixing.
+ */
+export function buildParams(endpoint) {
+    const properties = {};
+    const required = [];
+    const parameterMap = [];
+    const usedNames = new Set();
+    // Path params first (highest priority, always required)
+    for (const param of endpoint.parameters.filter((p) => p.in === "path")) {
+        const name = ensureUnique(param.name, usedNames);
+        properties[name] = { ...param.schema, description: param.description ?? param.schema.description };
+        required.push(name);
+        parameterMap.push({
+            toolParamName: name,
+            source: "path",
+            originalName: param.name,
+            required: true,
+        });
+    }
+    // Query params
+    for (const param of endpoint.parameters.filter((p) => p.in === "query")) {
+        const name = ensureUnique(param.name, usedNames, "query");
+        properties[name] = { ...param.schema, description: param.description ?? param.schema.description };
+        if (param.required)
+            required.push(name);
+        parameterMap.push({
+            toolParamName: name,
+            source: "query",
+            originalName: param.name,
+            required: param.required,
+        });
+    }
+    // Header params (skip standard headers)
+    const skipHeaders = new Set(["content-type", "accept", "authorization"]);
+    for (const param of endpoint.parameters.filter((p) => p.in === "header" && !skipHeaders.has(p.name.toLowerCase()))) {
+        const name = ensureUnique(param.name, usedNames, "header");
+        properties[name] = { ...param.schema, description: param.description ?? param.schema.description };
+        if (param.required)
+            required.push(name);
+        parameterMap.push({
+            toolParamName: name,
+            source: "header",
+            originalName: param.name,
+            required: param.required,
+        });
+    }
+    // Request body
+    if (endpoint.requestBody?.schema) {
+        const bodySchema = endpoint.requestBody.schema;
+        // If body has properties, flatten them into the top level
+        if (bodySchema.properties && Object.keys(bodySchema.properties).length <= 15) {
+            for (const [propName, propSchema] of Object.entries(bodySchema.properties)) {
+                const name = ensureUnique(propName, usedNames, "body");
+                properties[name] = propSchema;
+                parameterMap.push({
+                    toolParamName: name,
+                    source: "body",
+                    originalName: propName,
+                    required: bodySchema.required?.includes(propName) ?? false,
+                });
+                if (endpoint.requestBody.required &&
+                    bodySchema.required?.includes(propName)) {
+                    required.push(name);
+                }
+            }
+        }
+        else {
+            // Complex body: nest under "body" property
+            const name = ensureUnique("body", usedNames);
+            properties[name] = {
+                ...bodySchema,
+                description: endpoint.requestBody.description ?? bodySchema.description,
+            };
+            if (endpoint.requestBody.required)
+                required.push(name);
+            parameterMap.push({
+                toolParamName: name,
+                source: "body",
+                originalName: "body",
+                required: endpoint.requestBody.required,
+            });
+        }
+    }
+    const inputSchema = {
+        type: "object",
+        properties,
+    };
+    if (required.length > 0) {
+        inputSchema.required = required;
+    }
+    return { inputSchema, parameterMap };
+}
+function ensureUnique(name, used, prefixOnCollision) {
+    let candidate = name;
+    if (used.has(candidate) && prefixOnCollision) {
+        candidate = `${prefixOnCollision}_${name}`;
+    }
+    // Final collision fallback
+    let suffix = 2;
+    const base = candidate;
+    while (used.has(candidate)) {
+        candidate = `${base}_${suffix}`;
+        suffix++;
+    }
+    used.add(candidate);
+    return candidate;
+}
+//# sourceMappingURL=param-builder.js.map

package/dist/src/generator/param-builder.js.map

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

package/dist/src/generator/tool-generator.d.ts

@@ -0,0 +1,22 @@
+import type { JsonSchema, NormalizedSpec } from "../parser/types.js";
+import type { ParameterMapping } from "./param-builder.js";
+export interface GeneratedTool {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+    endpointRef: {
+        method: string;
+        path: string;
+        baseUrl: string;
+        contentType: string;
+        parameterMap: ParameterMapping[];
+    };
+}
+export interface GenerateOptions {
+    baseUrl?: string;
+    prefix?: string;
+    include?: string[];
+    exclude?: string[];
+}
+export declare function generateTools(spec: NormalizedSpec, options?: GenerateOptions): GeneratedTool[];
+//# sourceMappingURL=tool-generator.d.ts.map

package/dist/src/generator/tool-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-generator.d.ts","sourceRoot":"","sources":["../../../src/generator/tool-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAsB,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,gBAAgB,EAAE,CAAC;KACjC,CAAC;CACF;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,aAAa,CAC5B,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,eAAoB,GAC3B,aAAa,EAAE,CAyDjB"}

package/dist/src/generator/tool-generator.js

@@ -0,0 +1,66 @@
+import { logger } from "../utils/logger.js";
+import { buildParams } from "./param-builder.js";
+import { generateToolName, resolveCollisions } from "./tool-namer.js";
+export function generateTools(spec, options = {}) {
+    const baseUrl = options.baseUrl ?? spec.servers[0]?.url ?? "http://localhost";
+    let endpoints = spec.endpoints;
+    // Apply include filter
+    if (options.include?.length) {
+        const patterns = options.include;
+        endpoints = endpoints.filter((ep) => patterns.some((p) => matchPattern(ep.operationId, p)) ||
+            patterns.some((p) => matchPattern(ep.path, p)));
+    }
+    // Apply exclude filter
+    if (options.exclude?.length) {
+        const patterns = options.exclude;
+        endpoints = endpoints.filter((ep) => !patterns.some((p) => matchPattern(ep.operationId, p)) &&
+            !patterns.some((p) => matchPattern(ep.path, p)));
+    }
+    // Generate raw names
+    const rawNames = endpoints.map((ep) => generateToolName(ep.operationId, ep.method, ep.path, options.prefix));
+    // Resolve collisions
+    const names = resolveCollisions(rawNames);
+    // Build tools
+    const tools = endpoints.map((endpoint, i) => {
+        const { inputSchema, parameterMap } = buildParams(endpoint);
+        const description = buildDescription(endpoint);
+        return {
+            name: names[i],
+            description,
+            inputSchema,
+            endpointRef: {
+                method: endpoint.method.toUpperCase(),
+                path: endpoint.path,
+                baseUrl: baseUrl.replace(/\/$/, ""),
+                contentType: endpoint.requestBody?.contentType ?? "application/json",
+                parameterMap,
+            },
+        };
+    });
+    logger.info(`Generated ${tools.length} MCP tools from ${spec.info.title}`);
+    return tools;
+}
+function buildDescription(endpoint) {
+    const parts = [];
+    if (endpoint.summary) {
+        parts.push(endpoint.summary);
+    }
+    else if (endpoint.description) {
+        // Use first sentence of description
+        const firstSentence = endpoint.description.split(/\.\s/)[0];
+        parts.push(firstSentence.length < 200 ? firstSentence : firstSentence.slice(0, 200));
+    }
+    parts.push(`[${endpoint.method.toUpperCase()} ${endpoint.path}]`);
+    if (endpoint.deprecated) {
+        parts.push("(DEPRECATED)");
+    }
+    return parts.join(" ");
+}
+function matchPattern(value, pattern) {
+    if (pattern.includes("*")) {
+        const regex = new RegExp(`^${pattern.replace(/\*/g, ".*").replace(/\//g, "\\/")}$`);
+        return regex.test(value);
+    }
+    return value === pattern;
+}
+//# sourceMappingURL=tool-generator.js.map

package/dist/src/generator/tool-generator.js.map

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

package/dist/src/generator/tool-namer.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generate a deterministic MCP tool name from an endpoint.
+ * Priority: operationId → method + path segments
+ */
+export declare function generateToolName(operationId: string, method: string, path: string, prefix?: string): string;
+/**
+ * Resolve naming collisions by appending _2, _3, etc.
+ */
+export declare function resolveCollisions(names: string[]): string[];
+//# sourceMappingURL=tool-namer.d.ts.map

package/dist/src/generator/tool-namer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-namer.d.ts","sourceRoot":"","sources":["../../../src/generator/tool-namer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACb,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQ3D"}

package/dist/src/generator/tool-namer.js

@@ -0,0 +1,44 @@
+const MAX_TOOL_NAME_LENGTH = 64;
+/**
+ * Generate a deterministic MCP tool name from an endpoint.
+ * Priority: operationId → method + path segments
+ */
+export function generateToolName(operationId, method, path, prefix) {
+    let name = sanitizeOperationId(operationId);
+    if (prefix) {
+        name = `${sanitize(prefix)}_${name}`;
+    }
+    if (name.length > MAX_TOOL_NAME_LENGTH) {
+        name = name.slice(0, MAX_TOOL_NAME_LENGTH);
+    }
+    return name;
+}
+/**
+ * Resolve naming collisions by appending _2, _3, etc.
+ */
+export function resolveCollisions(names) {
+    const seen = new Map();
+    return names.map((name) => {
+        const count = seen.get(name) ?? 0;
+        seen.set(name, count + 1);
+        if (count === 0)
+            return name;
+        return `${name}_${count + 1}`.slice(0, MAX_TOOL_NAME_LENGTH);
+    });
+}
+function sanitizeOperationId(id) {
+    return id
+        .replace(/([a-z])([A-Z])/g, "$1_$2") // camelCase → snake_case
+        .replace(/[^a-zA-Z0-9_]/g, "_") // non-alphanumeric → underscore
+        .replace(/_+/g, "_") // collapse multiple underscores
+        .replace(/^_|_$/g, "") // trim leading/trailing underscores
+        .toLowerCase();
+}
+function sanitize(input) {
+    return input
+        .replace(/[^a-zA-Z0-9_]/g, "_")
+        .replace(/_+/g, "_")
+        .replace(/^_|_$/g, "")
+        .toLowerCase();
+}
+//# sourceMappingURL=tool-namer.js.map

package/dist/src/generator/tool-namer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-namer.js","sourceRoot":"","sources":["../../../src/generator/tool-namer.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC/B,WAAmB,EACnB,MAAc,EACd,IAAY,EACZ,MAAe;IAEf,IAAI,IAAI,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,MAAM,EAAE,CAAC;QACZ,IAAI,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IACtC,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;QACxC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,EAAU;IACtC,OAAO,EAAE;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,yBAAyB;SAC7D,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,gCAAgC;SAC/D,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,gCAAgC;SACpD,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,oCAAoC;SAC1D,WAAW,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC9B,OAAO,KAAK;SACV,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE,CAAC;AACjB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,7 @@
+export { createServer, startServer } from "./server.js";
+export type { McpOpenApiConfig, AuthConfig } from "./config/types.js";
+export { generateTools } from "./generator/tool-generator.js";
+export type { GeneratedTool } from "./generator/tool-generator.js";
+export { parseSpec } from "./parser/openapi-parser.js";
+export type { NormalizedSpec } from "./parser/types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export { createServer, startServer } from "./server.js";
+export { generateTools } from "./generator/tool-generator.js";
+export { parseSpec } from "./parser/openapi-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/src/parser/index.d.ts

@@ -0,0 +1,5 @@
+export { parseSpec } from "./openapi-parser.js";
+export { loadSpec } from "./spec-loader.js";
+export { convertToJsonSchema } from "./schema-converter.js";
+export type { NormalizedSpec, NormalizedEndpoint, NormalizedParameter, NormalizedRequestBody, NormalizedResponse, JsonSchema, SecurityScheme, SecurityRequirement, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACX,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,mBAAmB,GACnB,MAAM,YAAY,CAAC"}

package/dist/src/parser/index.js

@@ -0,0 +1,4 @@
+export { parseSpec } from "./openapi-parser.js";
+export { loadSpec } from "./spec-loader.js";
+export { convertToJsonSchema } from "./schema-converter.js";
+//# sourceMappingURL=index.js.map

package/dist/src/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/parser/openapi-parser.d.ts

@@ -0,0 +1,3 @@
+import type { NormalizedSpec } from "./types.js";
+export declare function parseSpec(specInput: string): Promise<NormalizedSpec>;
+//# sourceMappingURL=openapi-parser.d.ts.map

package/dist/src/parser/openapi-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-parser.d.ts","sourceRoot":"","sources":["../../../src/parser/openapi-parser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAKX,cAAc,EAEd,MAAM,YAAY,CAAC;AAYpB,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAY1E"}

package/dist/src/parser/openapi-parser.js

@@ -0,0 +1,287 @@
+import SwaggerParser from "@apidevtools/swagger-parser";
+import { SpecParseError } from "../utils/errors.js";
+import { logger } from "../utils/logger.js";
+import { convertToJsonSchema } from "./schema-converter.js";
+const HTTP_METHODS = [
+    "get",
+    "post",
+    "put",
+    "patch",
+    "delete",
+    "head",
+    "options",
+];
+export async function parseSpec(specInput) {
+    try {
+        const api = await SwaggerParser.dereference(specInput);
+        if (isSwagger2(api)) {
+            return normalizeV2(api);
+        }
+        return normalizeV3(api);
+    }
+    catch (error) {
+        throw new SpecParseError(`Failed to parse OpenAPI spec: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function isSwagger2(api) {
+    return "swagger" in api && api.swagger === "2.0";
+}
+function normalizeV3(doc) {
+    const endpoints = [];
+    const paths = doc.paths ?? {};
+    for (const [path, pathItem] of Object.entries(paths)) {
+        if (!pathItem)
+            continue;
+        // Path-level parameters
+        const pathParams = pathItem.parameters?.map(normalizeV3Parameter) ?? [];
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const opParams = operation.parameters?.map(normalizeV3Parameter) ?? [];
+            // Merge path-level and operation-level params (operation takes precedence)
+            const mergedParams = mergeParameters(pathParams, opParams);
+            const endpoint = {
+                method,
+                path,
+                operationId: operation.operationId ?? generateOperationId(method, path),
+                summary: operation.summary,
+                description: operation.description,
+                parameters: mergedParams,
+                requestBody: normalizeV3RequestBody(operation.requestBody),
+                responses: normalizeV3Responses((operation.responses ?? {})),
+                tags: operation.tags,
+                deprecated: operation.deprecated,
+            };
+            endpoints.push(endpoint);
+        }
+    }
+    logger.info(`Parsed ${endpoints.length} endpoints from ${doc.info.title} v${doc.info.version}`);
+    return {
+        info: {
+            title: doc.info.title,
+            version: doc.info.version,
+            description: doc.info.description,
+        },
+        servers: doc.servers?.map((s) => ({ url: s.url })) ?? [
+            { url: "http://localhost" },
+        ],
+        endpoints,
+        securitySchemes: normalizeV3SecuritySchemes(doc),
+    };
+}
+function normalizeV2(doc) {
+    const baseUrl = `${doc.schemes?.[0] ?? "https"}://${doc.host ?? "localhost"}${doc.basePath ?? ""}`;
+    const endpoints = [];
+    const paths = doc.paths ?? {};
+    for (const [path, pathItem] of Object.entries(paths)) {
+        if (!pathItem)
+            continue;
+        const pathParams = pathItem.parameters
+            ?.map(normalizeV2Parameter) ?? [];
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const opParams = operation.parameters
+                ?.filter((p) => p.in !== "body")
+                .map(normalizeV2Parameter) ?? [];
+            const mergedParams = mergeParameters(pathParams, opParams);
+            // Extract body parameter (Swagger 2.0 specific)
+            const bodyParam = operation.parameters
+                ?.find((p) => p.in === "body");
+            const endpoint = {
+                method,
+                path,
+                operationId: operation.operationId ?? generateOperationId(method, path),
+                summary: operation.summary,
+                description: operation.description,
+                parameters: mergedParams,
+                requestBody: bodyParam
+                    ? {
+                        required: bodyParam.required ?? false,
+                        description: bodyParam.description,
+                        contentType: operation.consumes?.[0] ?? "application/json",
+                        schema: convertToJsonSchema(bodyParam.schema),
+                    }
+                    : undefined,
+                responses: normalizeV2Responses((operation.responses ?? {})),
+                tags: operation.tags,
+                deprecated: operation.deprecated,
+            };
+            endpoints.push(endpoint);
+        }
+    }
+    logger.info(`Parsed ${endpoints.length} endpoints from ${doc.info.title} v${doc.info.version} (Swagger 2.0)`);
+    return {
+        info: {
+            title: doc.info.title,
+            version: doc.info.version,
+            description: doc.info.description,
+        },
+        servers: [{ url: baseUrl }],
+        endpoints,
+        securitySchemes: normalizeV2SecuritySchemes(doc),
+    };
+}
+function normalizeV3Parameter(param) {
+    return {
+        name: param.name,
+        in: param.in,
+        required: param.required ?? param.in === "path",
+        description: param.description,
+        schema: convertToJsonSchema(param.schema ?? { type: "string" }),
+    };
+}
+function normalizeV2Parameter(param) {
+    const general = param;
+    return {
+        name: general.name,
+        in: general.in,
+        required: general.required ?? general.in === "path",
+        description: general.description,
+        schema: convertToJsonSchema({
+            type: general.type,
+            format: general.format,
+            enum: general.enum,
+            default: general.default,
+            description: general.description,
+        }),
+    };
+}
+function normalizeV3RequestBody(body) {
+    if (!body?.content)
+        return undefined;
+    // Prefer application/json
+    const jsonContent = body.content["application/json"];
+    if (jsonContent?.schema) {
+        return {
+            required: body.required ?? false,
+            description: body.description,
+            contentType: "application/json",
+            schema: convertToJsonSchema(jsonContent.schema),
+        };
+    }
+    // Fallback to first content type
+    const [contentType, mediaType] = Object.entries(body.content)[0] ?? [];
+    if (contentType && mediaType?.schema) {
+        return {
+            required: body.required ?? false,
+            description: body.description,
+            contentType,
+            schema: convertToJsonSchema(mediaType.schema),
+        };
+    }
+    return undefined;
+}
+function normalizeV3Responses(responses) {
+    const result = {};
+    for (const [code, response] of Object.entries(responses)) {
+        const resp = response;
+        const jsonContent = resp.content?.["application/json"];
+        result[code] = {
+            description: resp.description,
+            contentType: jsonContent ? "application/json" : undefined,
+            schema: jsonContent?.schema
+                ? convertToJsonSchema(jsonContent.schema)
+                : undefined,
+        };
+    }
+    return result;
+}
+function normalizeV2Responses(responses) {
+    const result = {};
+    for (const [code, response] of Object.entries(responses)) {
+        result[code] = {
+            description: response.description,
+            schema: response.schema
+                ? convertToJsonSchema(response.schema)
+                : undefined,
+        };
+    }
+    return result;
+}
+function normalizeV3SecuritySchemes(doc) {
+    const schemes = {};
+    const components = doc.components?.securitySchemes ?? {};
+    for (const [name, scheme] of Object.entries(components)) {
+        const s = scheme;
+        if (s.type === "apiKey") {
+            schemes[name] = {
+                type: "apiKey",
+                name: s.name,
+                in: s.in,
+            };
+        }
+        else if (s.type === "http") {
+            schemes[name] = { type: "http", scheme: s.scheme, bearerFormat: s.bearerFormat };
+        }
+        else if (s.type === "oauth2") {
+            const flows = {};
+            if (s.flows) {
+                for (const [flowName, flow] of Object.entries(s.flows)) {
+                    if (flow) {
+                        flows[flowName] = {
+                            tokenUrl: flow.tokenUrl,
+                            scopes: flow.scopes ?? {},
+                        };
+                    }
+                }
+            }
+            schemes[name] = { type: "oauth2", flows };
+        }
+    }
+    return schemes;
+}
+function normalizeV2SecuritySchemes(doc) {
+    const schemes = {};
+    const definitions = doc.securityDefinitions ?? {};
+    for (const [name, scheme] of Object.entries(definitions)) {
+        if (scheme.type === "apiKey") {
+            schemes[name] = {
+                type: "apiKey",
+                name: scheme.name,
+                in: scheme.in,
+            };
+        }
+        else if (scheme.type === "basic") {
+            schemes[name] = { type: "http", scheme: "basic" };
+        }
+        else if (scheme.type === "oauth2") {
+            const oauthScheme = scheme;
+            schemes[name] = {
+                type: "oauth2",
+                flows: {
+                    [oauthScheme.flow]: {
+                        tokenUrl: "tokenUrl" in oauthScheme ? oauthScheme.tokenUrl : undefined,
+                        scopes: oauthScheme.scopes ?? {},
+                    },
+                },
+            };
+        }
+    }
+    return schemes;
+}
+function mergeParameters(pathLevel, operationLevel) {
+    const byKey = new Map();
+    for (const p of pathLevel) {
+        byKey.set(`${p.in}:${p.name}`, p);
+    }
+    for (const p of operationLevel) {
+        byKey.set(`${p.in}:${p.name}`, p); // operation overrides path
+    }
+    return [...byKey.values()];
+}
+function generateOperationId(method, path) {
+    const segments = path
+        .split("/")
+        .filter(Boolean)
+        .map((s) => {
+        if (s.startsWith("{") && s.endsWith("}")) {
+            return `by_${s.slice(1, -1)}`;
+        }
+        return s.replace(/-/g, "_");
+    });
+    return `${method}_${segments.join("_")}`.toLowerCase();
+}
+//# sourceMappingURL=openapi-parser.js.map

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

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

package/dist/src/parser/schema-converter.d.ts

@@ -0,0 +1,7 @@
+import type { JsonSchema } from "./types.js";
+/**
+ * Convert OAS-specific schema extensions into pure JSON Schema
+ * that MCP tools can accept.
+ */
+export declare function convertToJsonSchema(oasSchema: Record<string, unknown>): JsonSchema;
+//# sourceMappingURL=schema-converter.d.ts.map