@karlangas12/openapi-to-mcp 0.1.0

package/dist/schema/to-zod.js

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+/** Profundidad máxima de recursión, como red de seguridad ante schemas cíclicos. */
+const MAX_DEPTH = 40;
+/**
+ * Convierte un Objeto Schema de OpenAPI en un validador Zod para comprobar los
+ * argumentos entrantes de una herramienta antes de tocar la API subyacente.
+ */
+export function schemaToZod(schema, resolver, depth = 0) {
+    if (depth > MAX_DEPTH)
+        return z.any();
+    if (schema.$ref !== undefined) {
+        return schemaToZod(resolver.resolve(schema.$ref), resolver, depth + 1);
+    }
+    const nullableByType = Array.isArray(schema.type) && schema.type.includes('null');
+    const isNullable = schema.nullable === true || nullableByType;
+    let zod = buildBase(schema, resolver, depth);
+    if (isNullable)
+        zod = zod.nullable();
+    if (schema.description !== undefined)
+        zod = zod.describe(schema.description);
+    return zod;
+}
+function buildBase(schema, resolver, depth) {
+    // Combinadores primero: mandan sobre `type`.
+    if (schema.enum !== undefined && schema.enum.length > 0) {
+        return literalUnion(schema.enum);
+    }
+    if (schema.allOf !== undefined && schema.allOf.length > 0) {
+        return schema.allOf
+            .map((sub) => schemaToZod(sub, resolver, depth + 1))
+            .reduce((acc, next) => z.intersection(acc, next));
+    }
+    if (schema.oneOf !== undefined && schema.oneOf.length > 0) {
+        return unionOf(schema.oneOf.map((sub) => schemaToZod(sub, resolver, depth + 1)));
+    }
+    if (schema.anyOf !== undefined && schema.anyOf.length > 0) {
+        return unionOf(schema.anyOf.map((sub) => schemaToZod(sub, resolver, depth + 1)));
+    }
+    const type = normalizeType(schema.type);
+    switch (type) {
+        case 'string':
+            return buildString(schema);
+        case 'integer':
+            return applyNumberBounds(z.number().int(), schema);
+        case 'number':
+            return applyNumberBounds(z.number(), schema);
+        case 'boolean':
+            return z.boolean();
+        case 'array': {
+            const items = schema.items ? schemaToZod(schema.items, resolver, depth + 1) : z.any();
+            return applyArrayBounds(z.array(items), schema);
+        }
+        case 'object':
+            return buildObject(schema, resolver, depth);
+        default:
+            // Sin `type` pero con `properties`: se trata como objeto.
+            if (schema.properties !== undefined)
+                return buildObject(schema, resolver, depth);
+            return z.any();
+    }
+}
+function buildString(schema) {
+    let str = z.string();
+    if (typeof schema.minLength === 'number')
+        str = str.min(schema.minLength);
+    if (typeof schema.maxLength === 'number')
+        str = str.max(schema.maxLength);
+    switch (schema.format) {
+        case 'email':
+            return str.email();
+        case 'uri':
+        case 'url':
+            return str.url();
+        case 'uuid':
+            return str.uuid();
+        default:
+            return str;
+    }
+}
+function applyNumberBounds(base, schema) {
+    let num = base;
+    if (typeof schema.minimum === 'number')
+        num = num.min(schema.minimum);
+    if (typeof schema.maximum === 'number')
+        num = num.max(schema.maximum);
+    return num;
+}
+function applyArrayBounds(base, schema) {
+    let arr = base;
+    if (typeof schema.minItems === 'number')
+        arr = arr.min(schema.minItems);
+    if (typeof schema.maxItems === 'number')
+        arr = arr.max(schema.maxItems);
+    return arr;
+}
+function buildObject(schema, resolver, depth) {
+    const properties = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const shape = {};
+    for (const [key, propSchema] of Object.entries(properties)) {
+        const zod = schemaToZod(propSchema, resolver, depth + 1);
+        shape[key] = required.has(key) ? zod : zod.optional();
+    }
+    const base = z.object(shape);
+    // Permisivo por defecto: una API puede añadir campos y no queremos rechazar
+    // argumentos válidos. Sólo se cierra si el schema prohíbe extras explícitamente.
+    return schema.additionalProperties === false ? base.strict() : base.passthrough();
+}
+function normalizeType(type) {
+    if (type === undefined)
+        return undefined;
+    if (Array.isArray(type))
+        return type.find((t) => t !== 'null');
+    return type;
+}
+function literalUnion(values) {
+    const literals = values
+        .filter((v) => ['string', 'number', 'boolean'].includes(typeof v))
+        .map((v) => z.literal(v));
+    if (literals.length === 0)
+        return z.any();
+    return unionOf(literals);
+}
+function unionOf(members) {
+    if (members.length === 0)
+        return z.any();
+    if (members.length === 1)
+        return members[0];
+    return z.union(members);
+}
+//# sourceMappingURL=to-zod.js.map

package/dist/schema/to-zod.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Errores tipados de la factoría.
+ *
+ * Todo error que atraviese la frontera HTTP debe ser un `AppError`: así el
+ * manejador central sabe qué código devolver y qué exponer al cliente sin
+ * filtrar detalles internos.
+ */
+/** Códigos de error estables que el cliente puede tratar programáticamente. */
+export declare const ERROR_CODES: readonly ["bad_request", "unauthorized", "forbidden", "not_found", "conflict", "payload_too_large", "rate_limited", "internal_error", "not_implemented", "service_unavailable"];
+export type ErrorCode = (typeof ERROR_CODES)[number];
+export interface AppErrorOptions {
+    /** Detalles adicionales seguros de exponer al cliente (p. ej. errores de validación). */
+    readonly details?: unknown;
+    /** Error original que provocó este, para la traza interna. Nunca se expone. */
+    readonly cause?: unknown;
+    /** Cabeceras extra a incluir en la respuesta (p. ej. `Retry-After`). */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/**
+ * Error de aplicación con código estable y estado HTTP asociado.
+ *
+ * El `message` se considera seguro de mostrar al cliente; usa `cause` para
+ * todo lo que deba quedarse en los logs.
+ */
+export declare class AppError extends Error {
+    readonly code: ErrorCode;
+    readonly status: number;
+    readonly details: unknown;
+    readonly headers: Readonly<Record<string, string>>;
+    constructor(code: ErrorCode, message: string, options?: AppErrorOptions);
+    /** Indica si el error es responsabilidad del cliente (4xx) o nuestra (5xx). */
+    get isClientError(): boolean;
+}
+/** Comprueba si un valor desconocido es un `AppError`. */
+export declare function isAppError(value: unknown): value is AppError;
+/**
+ * Normaliza cualquier valor lanzado a un `AppError`.
+ *
+ * Los errores inesperados se convierten en `internal_error` con un mensaje
+ * genérico: el detalle real viaja en `cause` para la telemetría, no al cliente.
+ */
+export declare function toAppError(value: unknown): AppError;
+export declare const badRequest: (message: string, details?: unknown) => AppError;
+export declare const unauthorized: (message?: string) => AppError;
+export declare const forbidden: (message?: string) => AppError;
+export declare const notFound: (message?: string) => AppError;
+export declare const rateLimited: (message: string, retryAfterSeconds: number) => AppError;

package/dist/utils/errors.js

@@ -0,0 +1,81 @@
+/**
+ * Errores tipados de la factoría.
+ *
+ * Todo error que atraviese la frontera HTTP debe ser un `AppError`: así el
+ * manejador central sabe qué código devolver y qué exponer al cliente sin
+ * filtrar detalles internos.
+ */
+/** Códigos de error estables que el cliente puede tratar programáticamente. */
+export const ERROR_CODES = [
+    'bad_request',
+    'unauthorized',
+    'forbidden',
+    'not_found',
+    'conflict',
+    'payload_too_large',
+    'rate_limited',
+    'internal_error',
+    'not_implemented',
+    'service_unavailable',
+];
+/** Correspondencia entre código de error y estado HTTP. */
+const HTTP_STATUS_BY_CODE = {
+    bad_request: 400,
+    unauthorized: 401,
+    forbidden: 403,
+    not_found: 404,
+    conflict: 409,
+    payload_too_large: 413,
+    rate_limited: 429,
+    internal_error: 500,
+    not_implemented: 501,
+    service_unavailable: 503,
+};
+/**
+ * Error de aplicación con código estable y estado HTTP asociado.
+ *
+ * El `message` se considera seguro de mostrar al cliente; usa `cause` para
+ * todo lo que deba quedarse en los logs.
+ */
+export class AppError extends Error {
+    code;
+    status;
+    details;
+    headers;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'AppError';
+        this.code = code;
+        this.status = HTTP_STATUS_BY_CODE[code];
+        this.details = options.details;
+        this.headers = options.headers ?? {};
+    }
+    /** Indica si el error es responsabilidad del cliente (4xx) o nuestra (5xx). */
+    get isClientError() {
+        return this.status >= 400 && this.status < 500;
+    }
+}
+/** Comprueba si un valor desconocido es un `AppError`. */
+export function isAppError(value) {
+    return value instanceof AppError;
+}
+/**
+ * Normaliza cualquier valor lanzado a un `AppError`.
+ *
+ * Los errores inesperados se convierten en `internal_error` con un mensaje
+ * genérico: el detalle real viaja en `cause` para la telemetría, no al cliente.
+ */
+export function toAppError(value) {
+    if (isAppError(value))
+        return value;
+    return new AppError('internal_error', 'Se ha producido un error interno.', { cause: value });
+}
+// --- Atajos de uso frecuente -------------------------------------------------
+export const badRequest = (message, details) => new AppError('bad_request', message, details === undefined ? {} : { details });
+export const unauthorized = (message = 'Credenciales ausentes o no válidas.') => new AppError('unauthorized', message);
+export const forbidden = (message = 'No tienes permiso para realizar esta acción.') => new AppError('forbidden', message);
+export const notFound = (message = 'Recurso no encontrado.') => new AppError('not_found', message);
+export const rateLimited = (message, retryAfterSeconds) => new AppError('rate_limited', message, {
+    headers: { 'Retry-After': String(Math.max(0, Math.ceil(retryAfterSeconds))) },
+});
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/http.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Utilidades de respuesta HTTP.
+ *
+ * Toda la factoría habla el mismo dialecto JSON, de modo que cualquier cliente
+ * (o cualquier activo que consuma a otro) pueda tratar las respuestas igual:
+ *
+ *   Éxito:  { "ok": true,  "data": ... }
+ *   Error:  { "ok": false, "error": { "code": ..., "message": ..., "details"?: ... } }
+ */
+export interface SuccessBody<T> {
+    readonly ok: true;
+    readonly data: T;
+}
+export interface ErrorBody {
+    readonly ok: false;
+    readonly error: {
+        readonly code: string;
+        readonly message: string;
+        readonly details?: unknown;
+    };
+}
+export type ApiBody<T> = SuccessBody<T> | ErrorBody;
+export interface ResponseOptions {
+    readonly status?: number;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/** Construye una respuesta JSON con las cabeceras correctas. */
+export declare function json<T>(body: T, options?: ResponseOptions): Response;
+/** Respuesta de éxito envuelta en el sobre estándar. */
+export declare function ok<T>(data: T, options?: ResponseOptions): Response;
+/** Respuesta 204 sin cuerpo, para operaciones que no devuelven nada. */
+export declare function noContent(headers?: Readonly<Record<string, string>>): Response;
+/**
+ * Respuesta de error a partir de cualquier valor lanzado.
+ *
+ * Los errores 5xx nunca exponen el mensaje original: se sustituye por uno
+ * genérico para no filtrar detalles de implementación.
+ */
+export declare function fail(error: unknown, options?: ResponseOptions): Response;
+/**
+ * Lee y parsea el cuerpo JSON de una petición.
+ *
+ * Lanza `bad_request` si el cuerpo no es JSON válido, en lugar de dejar
+ * escapar un `SyntaxError` crudo hasta el manejador de errores.
+ */
+export declare function readJson(request: Request): Promise<unknown>;

package/dist/utils/http.js

@@ -0,0 +1,70 @@
+/**
+ * Utilidades de respuesta HTTP.
+ *
+ * Toda la factoría habla el mismo dialecto JSON, de modo que cualquier cliente
+ * (o cualquier activo que consuma a otro) pueda tratar las respuestas igual:
+ *
+ *   Éxito:  { "ok": true,  "data": ... }
+ *   Error:  { "ok": false, "error": { "code": ..., "message": ..., "details"?: ... } }
+ */
+import { AppError, toAppError } from './errors.js';
+/** Construye una respuesta JSON con las cabeceras correctas. */
+export function json(body, options = {}) {
+    return new Response(JSON.stringify(body), {
+        status: options.status ?? 200,
+        headers: {
+            'Content-Type': 'application/json; charset=utf-8',
+            ...options.headers,
+        },
+    });
+}
+/** Respuesta de éxito envuelta en el sobre estándar. */
+export function ok(data, options = {}) {
+    const body = { ok: true, data };
+    return json(body, options);
+}
+/** Respuesta 204 sin cuerpo, para operaciones que no devuelven nada. */
+export function noContent(headers = {}) {
+    return new Response(null, { status: 204, headers: { ...headers } });
+}
+/**
+ * Respuesta de error a partir de cualquier valor lanzado.
+ *
+ * Los errores 5xx nunca exponen el mensaje original: se sustituye por uno
+ * genérico para no filtrar detalles de implementación.
+ */
+export function fail(error, options = {}) {
+    const appError = toAppError(error);
+    const safeMessage = appError.isClientError
+        ? appError.message
+        : 'Se ha producido un error interno.';
+    const body = {
+        ok: false,
+        error: {
+            code: appError.code,
+            message: safeMessage,
+            ...(appError.isClientError && appError.details !== undefined
+                ? { details: appError.details }
+                : {}),
+        },
+    };
+    return json(body, {
+        status: options.status ?? appError.status,
+        headers: { ...appError.headers, ...options.headers },
+    });
+}
+/**
+ * Lee y parsea el cuerpo JSON de una petición.
+ *
+ * Lanza `bad_request` si el cuerpo no es JSON válido, en lugar de dejar
+ * escapar un `SyntaxError` crudo hasta el manejador de errores.
+ */
+export async function readJson(request) {
+    try {
+        return await request.json();
+    }
+    catch (cause) {
+        throw new AppError('bad_request', 'El cuerpo de la petición no es JSON válido.', { cause });
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/utils/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuBnD,gEAAgE;AAChE,MAAM,UAAU,IAAI,CAAI,IAAO,EAAE,UAA2B,EAAE;IAC5D,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG;QAC7B,OAAO,EAAE;YACP,cAAc,EAAE,iCAAiC;YACjD,GAAG,OAAO,CAAC,OAAO;SACnB;KACF,CAAC,CAAC;AACL,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,EAAE,CAAI,IAAO,EAAE,UAA2B,EAAE;IAC1D,MAAM,IAAI,GAAmB,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChD,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,SAAS,CAAC,UAA4C,EAAE;IACtE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,KAAc,EAAE,UAA2B,EAAE;IAChE,MAAM,QAAQ,GAAa,UAAU,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa;QACxC,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,mCAAmC,CAAC;IAExC,MAAM,IAAI,GAAc;QACtB,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,WAAW;YACpB,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;gBAC1D,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE;gBAC/B,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;IAEF,OAAO,IAAI,CAAC,IAAI,EAAE;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM;QACzC,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;KACrD,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAgB;IAC7C,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,6CAA6C,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+/** Punto de entrada de las utilidades comunes de la factoría. */
+export * from './errors.js';
+export * from './http.js';
+export * from './time.js';

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+/** Punto de entrada de las utilidades comunes de la factoría. */
+export * from './errors.js';
+export * from './http.js';
+export * from './time.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Utilidades de tiempo.
+ *
+ * Todo el código que necesite "ahora" debe pedirlo por inyección (`Clock`) en
+ * lugar de llamar a `Date.now()` directamente: así los tests controlan el paso
+ * del tiempo sin recurrir a temporizadores falsos.
+ */
+/** Fuente de tiempo inyectable. Devuelve milisegundos desde la época Unix. */
+export interface Clock {
+    now(): number;
+}
+/** Reloj real del sistema. Es el valor por defecto en producción. */
+export declare const systemClock: Clock;
+/**
+ * Reloj controlable para tests: avanza sólo cuando se lo pides.
+ *
+ * @param startMs Instante inicial en milisegundos (por defecto 0).
+ */
+export declare function createTestClock(startMs?: number): Clock & {
+    advance(ms: number): void;
+};
+/** Convierte segundos a milisegundos. */
+export declare const seconds: (n: number) => number;
+/** Convierte minutos a milisegundos. */
+export declare const minutes: (n: number) => number;
+/** Convierte horas a milisegundos. */
+export declare const hours: (n: number) => number;

package/dist/utils/time.js

@@ -0,0 +1,32 @@
+/**
+ * Utilidades de tiempo.
+ *
+ * Todo el código que necesite "ahora" debe pedirlo por inyección (`Clock`) en
+ * lugar de llamar a `Date.now()` directamente: así los tests controlan el paso
+ * del tiempo sin recurrir a temporizadores falsos.
+ */
+/** Reloj real del sistema. Es el valor por defecto en producción. */
+export const systemClock = {
+    now: () => Date.now(),
+};
+/**
+ * Reloj controlable para tests: avanza sólo cuando se lo pides.
+ *
+ * @param startMs Instante inicial en milisegundos (por defecto 0).
+ */
+export function createTestClock(startMs = 0) {
+    let current = startMs;
+    return {
+        now: () => current,
+        advance: (ms) => {
+            current += ms;
+        },
+    };
+}
+/** Convierte segundos a milisegundos. */
+export const seconds = (n) => n * 1000;
+/** Convierte minutos a milisegundos. */
+export const minutes = (n) => n * 60_000;
+/** Convierte horas a milisegundos. */
+export const hours = (n) => n * 3_600_000;
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,qEAAqE;AACrE,MAAM,CAAC,MAAM,WAAW,GAAU;IAChC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAAG,CAAC;IACzC,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,EAAU,EAAE,EAAE;YACtB,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAEvD,wCAAwC;AACxC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;AAEzD,sCAAsC;AACtC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "@karlangas12/openapi-to-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Turn any OpenAPI 3.x spec into a live Model Context Protocol (MCP) server: every endpoint becomes a validated tool your AI agent can call.",
+  "license": "MIT",
+  "author": "Karlangas12",
+  "homepage": "https://github.com/Karlangas12/openapi-to-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Karlangas12/openapi-to-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Karlangas12/openapi-to-mcp/issues"
+  },
+  "keywords": [
+    "openapi",
+    "swagger",
+    "mcp",
+    "model-context-protocol",
+    "openapi-to-mcp",
+    "ai",
+    "agent",
+    "tools",
+    "claude",
+    "cursor",
+    "json-rpc",
+    "zod",
+    "codegen",
+    "developer-tools",
+    "llm"
+  ],
+  "bin": {
+    "openapi-to-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "dependencies": {
+    "yaml": "^2.6.1",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}