mcp-openapi 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-converter.d.ts","sourceRoot":"","sources":["../../../src/parser/schema-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAoElF"}

package/dist/src/parser/schema-converter.js

@@ -0,0 +1,86 @@
+/**
+ * Convert OAS-specific schema extensions into pure JSON Schema
+ * that MCP tools can accept.
+ */
+export function convertToJsonSchema(oasSchema) {
+    if (!oasSchema || typeof oasSchema !== "object") {
+        return { type: "string" };
+    }
+    const schema = {};
+    // Copy basic properties
+    if (oasSchema.type)
+        schema.type = String(oasSchema.type);
+    if (oasSchema.description)
+        schema.description = String(oasSchema.description);
+    if (oasSchema.format)
+        schema.format = String(oasSchema.format);
+    if (oasSchema.default !== undefined)
+        schema.default = oasSchema.default;
+    if (Array.isArray(oasSchema.enum))
+        schema.enum = oasSchema.enum;
+    // Handle nullable (OAS 3.0 extension)
+    if (oasSchema.nullable === true && schema.type) {
+        // JSON Schema doesn't have nullable, express as type array or leave as-is for MCP
+    }
+    // Handle properties (object type)
+    if (oasSchema.properties && typeof oasSchema.properties === "object") {
+        schema.type = "object";
+        schema.properties = {};
+        for (const [key, value] of Object.entries(oasSchema.properties)) {
+            if (value && typeof value === "object") {
+                schema.properties[key] = convertToJsonSchema(value);
+            }
+        }
+    }
+    // Handle required
+    if (Array.isArray(oasSchema.required)) {
+        schema.required = oasSchema.required.filter((r) => typeof r === "string");
+    }
+    // Handle items (array type)
+    if (oasSchema.items && typeof oasSchema.items === "object") {
+        schema.type = "array";
+        schema.items = convertToJsonSchema(oasSchema.items);
+    }
+    // Handle allOf — merge into single schema
+    if (Array.isArray(oasSchema.allOf)) {
+        return mergeAllOf(oasSchema.allOf);
+    }
+    // Handle oneOf/anyOf — pick first as best effort
+    if (Array.isArray(oasSchema.oneOf) && oasSchema.oneOf.length > 0) {
+        const first = oasSchema.oneOf[0];
+        if (first && typeof first === "object") {
+            return convertToJsonSchema(first);
+        }
+    }
+    if (Array.isArray(oasSchema.anyOf) && oasSchema.anyOf.length > 0) {
+        const first = oasSchema.anyOf[0];
+        if (first && typeof first === "object") {
+            return convertToJsonSchema(first);
+        }
+    }
+    // Default to string if no type detected
+    if (!schema.type && !schema.properties && !schema.items) {
+        schema.type = "string";
+    }
+    return schema;
+}
+function mergeAllOf(schemas) {
+    const merged = { type: "object", properties: {}, required: [] };
+    for (const sub of schemas) {
+        const converted = convertToJsonSchema(sub);
+        if (converted.properties) {
+            Object.assign(merged.properties, converted.properties);
+        }
+        if (converted.required) {
+            merged.required.push(...converted.required);
+        }
+        if (converted.description && !merged.description) {
+            merged.description = converted.description;
+        }
+    }
+    if (merged.required.length === 0) {
+        delete merged.required;
+    }
+    return merged;
+}
+//# sourceMappingURL=schema-converter.js.map

package/dist/src/parser/schema-converter.js.map

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

package/dist/src/parser/spec-loader.d.ts

@@ -0,0 +1,6 @@
+export interface LoadedSpec {
+    content: string;
+    format: "json" | "yaml";
+}
+export declare function loadSpec(input: string): Promise<LoadedSpec>;
+//# sourceMappingURL=spec-loader.d.ts.map

package/dist/src/parser/spec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.d.ts","sourceRoot":"","sources":["../../../src/parser/spec-loader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAeD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAKjE"}

package/dist/src/parser/spec-loader.js

@@ -0,0 +1,53 @@
+import { readFile } from "node:fs/promises";
+import { SpecLoadError } from "../utils/errors.js";
+import { logger } from "../utils/logger.js";
+function isUrl(input) {
+    return input.startsWith("http://") || input.startsWith("https://");
+}
+function detectFormat(input, content) {
+    if (input.endsWith(".json"))
+        return "json";
+    if (input.endsWith(".yaml") || input.endsWith(".yml"))
+        return "yaml";
+    // Try to detect from content
+    const trimmed = content.trimStart();
+    if (trimmed.startsWith("{") || trimmed.startsWith("["))
+        return "json";
+    return "yaml";
+}
+export async function loadSpec(input) {
+    if (isUrl(input)) {
+        return loadFromUrl(input);
+    }
+    return loadFromFile(input);
+}
+async function loadFromUrl(url) {
+    logger.info(`Fetching spec from ${url}`);
+    try {
+        const response = await fetch(url, {
+            headers: { Accept: "application/json, application/yaml, text/yaml, */*" },
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            throw new SpecLoadError(`Failed to fetch spec: ${response.status} ${response.statusText}`);
+        }
+        const content = await response.text();
+        return { content, format: detectFormat(url, content) };
+    }
+    catch (error) {
+        if (error instanceof SpecLoadError)
+            throw error;
+        throw new SpecLoadError(`Failed to fetch spec from ${url}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function loadFromFile(filePath) {
+    logger.info(`Reading spec from ${filePath}`);
+    try {
+        const content = await readFile(filePath, "utf-8");
+        return { content, format: detectFormat(filePath, content) };
+    }
+    catch (error) {
+        throw new SpecLoadError(`Failed to read spec file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=spec-loader.js.map

package/dist/src/parser/spec-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.js","sourceRoot":"","sources":["../../../src/parser/spec-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAO5C,SAAS,KAAK,CAAC,KAAa;IAC3B,OAAO,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,OAAe;IACnD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACrE,6BAA6B;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACtE,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAa;IAC3C,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACjC,OAAO,EAAE,EAAE,MAAM,EAAE,oDAAoD,EAAE;YACzE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,aAAa,CACtB,yBAAyB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACjE,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,aAAa;YAAE,MAAM,KAAK,CAAC;QAChD,MAAM,IAAI,aAAa,CACtB,6BAA6B,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7F,CAAC;IACH,CAAC;AACF,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,CAAC,IAAI,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,aAAa,CACtB,4BAA4B,QAAQ,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACjG,CAAC;IACH,CAAC;AACF,CAAC"}

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

@@ -0,0 +1,72 @@
+/** JSON Schema subset that MCP tools accept */
+export type JsonSchema = {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    description?: string;
+    enum?: unknown[];
+    default?: unknown;
+    format?: string;
+    [key: string]: unknown;
+};
+export interface NormalizedSpec {
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers: Array<{
+        url: string;
+    }>;
+    endpoints: NormalizedEndpoint[];
+    securitySchemes: Record<string, SecurityScheme>;
+}
+export interface NormalizedEndpoint {
+    method: "get" | "post" | "put" | "patch" | "delete" | "head" | "options";
+    path: string;
+    operationId: string;
+    summary?: string;
+    description?: string;
+    parameters: NormalizedParameter[];
+    requestBody?: NormalizedRequestBody;
+    responses: Record<string, NormalizedResponse>;
+    security?: SecurityRequirement[];
+    tags?: string[];
+    deprecated?: boolean;
+}
+export interface NormalizedParameter {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    required: boolean;
+    description?: string;
+    schema: JsonSchema;
+}
+export interface NormalizedRequestBody {
+    required: boolean;
+    description?: string;
+    contentType: string;
+    schema: JsonSchema;
+}
+export interface NormalizedResponse {
+    description?: string;
+    contentType?: string;
+    schema?: JsonSchema;
+}
+export type SecurityScheme = {
+    type: "apiKey";
+    name: string;
+    in: "header" | "query" | "cookie";
+} | {
+    type: "http";
+    scheme: string;
+    bearerFormat?: string;
+} | {
+    type: "oauth2";
+    flows: Record<string, {
+        tokenUrl?: string;
+        scopes: Record<string, string>;
+    }>;
+};
+export type SecurityRequirement = Record<string, string[]>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/parser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/parser/types.ts"],"names":[],"mappings":""}

package/dist/src/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpOpenApiConfig } from "./config/types.js";
+export declare function createServer(config: McpOpenApiConfig): Promise<{
+    server: McpServer;
+    tools: import("./index.js").GeneratedTool[];
+    spec: import("./index.js").NormalizedSpec;
+}>;
+export declare function startServer(config: McpOpenApiConfig): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS1D,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB;;;;GAiE1D;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,gBAAgB,iBAOzD"}

package/dist/src/server.js

@@ -0,0 +1,61 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createAuthProvider } from "./auth/index.js";
+import { DEFAULT_CONFIG } from "./config/types.js";
+import { buildRequest } from "./executor/request-builder.js";
+import { executeRequest } from "./executor/http-client.js";
+import { mapResponse } from "./executor/response-mapper.js";
+import { generateTools } from "./generator/tool-generator.js";
+import { parseSpec } from "./parser/openapi-parser.js";
+import { logger } from "./utils/logger.js";
+export async function createServer(config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    // Parse the OpenAPI spec
+    const spec = await parseSpec(config.spec);
+    // Generate MCP tools
+    const tools = generateTools(spec, {
+        baseUrl: mergedConfig.baseUrl,
+        prefix: mergedConfig.prefix,
+        include: mergedConfig.include,
+        exclude: mergedConfig.exclude,
+    });
+    if (tools.length === 0) {
+        logger.warn("No tools generated from the spec. Check your include/exclude filters.");
+    }
+    // Create auth provider
+    const authProvider = createAuthProvider(mergedConfig.auth);
+    // Create MCP server
+    const server = new McpServer({
+        name: `mcp-openapi: ${spec.info.title}`,
+        version: spec.info.version,
+    });
+    // Register each tool
+    for (const tool of tools) {
+        server.tool(tool.name, tool.description, tool.inputSchema.properties
+            ? tool.inputSchema
+            : { properties: {} }, async (args) => {
+            // Build HTTP request from tool call args
+            let request = buildRequest(args, tool.endpointRef, mergedConfig.headers);
+            // Apply auth
+            if (authProvider) {
+                request = await authProvider.apply(request);
+            }
+            // Execute HTTP request
+            const response = await executeRequest(request, {
+                timeout: mergedConfig.timeout,
+                maxRetries: mergedConfig.maxRetries,
+            });
+            // Map to MCP result
+            return mapResponse(response);
+        });
+    }
+    logger.info(`Registered ${tools.length} tools from ${spec.info.title} v${spec.info.version}`);
+    return { server, tools, spec };
+}
+export async function startServer(config) {
+    const { server } = await createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info("MCP server running on stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

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

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class McpOpenApiError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class SpecLoadError extends McpOpenApiError {
+    constructor(message: string);
+}
+export declare class SpecParseError extends McpOpenApiError {
+    constructor(message: string);
+}
+export declare class AuthError extends McpOpenApiError {
+    constructor(message: string);
+}
+export declare class HttpRequestError extends McpOpenApiError {
+    readonly statusCode?: number | undefined;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, responseBody?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;aAGxB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK7B;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACrC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,cAAe,SAAQ,eAAe;gBACtC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,SAAU,SAAQ,eAAe;gBACjC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,gBAAiB,SAAQ,eAAe;aAGnC,UAAU,CAAC,EAAE,MAAM;aACnB,YAAY,CAAC,EAAE,MAAM;gBAFrC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,YAAY,CAAC,EAAE,MAAM,YAAA;CAKtC"}

package/dist/src/utils/errors.js

@@ -0,0 +1,37 @@
+export class McpOpenApiError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "McpOpenApiError";
+    }
+}
+export class SpecLoadError extends McpOpenApiError {
+    constructor(message) {
+        super(message, "SPEC_LOAD_ERROR");
+        this.name = "SpecLoadError";
+    }
+}
+export class SpecParseError extends McpOpenApiError {
+    constructor(message) {
+        super(message, "SPEC_PARSE_ERROR");
+        this.name = "SpecParseError";
+    }
+}
+export class AuthError extends McpOpenApiError {
+    constructor(message) {
+        super(message, "AUTH_ERROR");
+        this.name = "AuthError";
+    }
+}
+export class HttpRequestError extends McpOpenApiError {
+    statusCode;
+    responseBody;
+    constructor(message, statusCode, responseBody) {
+        super(message, "HTTP_REQUEST_ERROR");
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.name = "HttpRequestError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAGxB;IAFjB,YACC,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,eAAe;IACjD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,eAAe;IAClD,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,SAAU,SAAQ,eAAe;IAC7C,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IACzB,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IAGnC;IACA;IAHjB,YACC,OAAe,EACC,UAAmB,EACnB,YAAqB;QAErC,KAAK,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;QAHrB,eAAU,GAAV,UAAU,CAAS;QACnB,iBAAY,GAAZ,YAAY,CAAS;QAGrC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;CACD"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,8 @@
+/** Logs to stderr only — stdout is reserved for MCP stdio transport */
+export declare const logger: {
+    info: (msg: string, ...args: unknown[]) => void;
+    warn: (msg: string, ...args: unknown[]) => void;
+    error: (msg: string, ...args: unknown[]) => void;
+    debug: (msg: string, ...args: unknown[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,MAAM;gBACN,MAAM,WAAW,OAAO,EAAE;gBAE1B,MAAM,WAAW,OAAO,EAAE;iBAEzB,MAAM,WAAW,OAAO,EAAE;iBAE1B,MAAM,WAAW,OAAO,EAAE;CAKvC,CAAC"}

package/dist/src/utils/logger.js

@@ -0,0 +1,12 @@
+/** Logs to stderr only — stdout is reserved for MCP stdio transport */
+export const logger = {
+    info: (msg, ...args) => console.error(`[mcp-openapi] ${msg}`, ...args),
+    warn: (msg, ...args) => console.error(`[mcp-openapi] WARN: ${msg}`, ...args),
+    error: (msg, ...args) => console.error(`[mcp-openapi] ERROR: ${msg}`, ...args),
+    debug: (msg, ...args) => {
+        if (process.env.DEBUG) {
+            console.error(`[mcp-openapi] DEBUG: ${msg}`, ...args);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE,CACzC,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE,CACzC,OAAO,CAAC,KAAK,CAAC,uBAAuB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IACrD,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE,CAC1C,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IACtD,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAE,EAAE;QAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACvD,CAAC;IACF,CAAC;CACD,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "mcp-openapi",
+  "version": "0.1.0",
+  "description": "LLM-aware OpenAPI/Swagger to MCP tools converter. Point at any API spec, get instant MCP tools.",
+  "type": "module",
+  "bin": {
+    "mcp-openapi": "./dist/bin/mcp-openapi.js"
+  },
+  "exports": {
+    ".": "./dist/src/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@apidevtools/swagger-parser": "^10.1.0",
+    "yaml": "^2.6.0",
+    "openapi-types": "^12.1.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "openapi",
+    "swagger",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "api",
+    "tools"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Docat0209/auto-revenue",
+    "directory": "packages/mcp-servers/openapi"
+  }
+}