swagger-parser-mcp-server 1.0.6 → 1.1.0

package/dist/utils/swaggerCache.d.ts

@@ -0,0 +1,53 @@
+import { OpenAPIDocument } from './types.js';
+/**
+ * Cache manager for OpenAPI documents
+ */
+export declare class SwaggerCache {
+    private cache;
+    private loadingPromises;
+    /**
+     * Loads and caches an OpenAPI document from URL
+     */
+    load(url: string): Promise<OpenAPIDocument>;
+    /**
+     * Gets a cached OpenAPI document
+     */
+    get(url: string): OpenAPIDocument | undefined;
+    /**
+     * Checks if a URL is cached
+     */
+    has(url: string): boolean;
+    /**
+     * Gets an OpenAPI document, loading it if not cached
+     */
+    getOrLoad(url: string): Promise<OpenAPIDocument>;
+    /**
+     * Clears a specific URL from cache
+     */
+    clear(url: string): boolean;
+    /**
+     * Clears all cached documents
+     */
+    clearAll(): void;
+    /**
+     * Gets cache statistics
+     */
+    getStats(): {
+        cacheSize: number;
+        loadingPromises: number;
+        cachedUrls: string[];
+    };
+    /**
+     * Preloads multiple URLs concurrently
+     */
+    preload(urls: string[]): Promise<void>;
+    /**
+     * Validates that a cached document is a valid OpenAPI document
+     */
+    private validateOpenAPIDocument;
+    /**
+     * Fetches OpenAPI document from URL with validation
+     */
+    private fetchSwagger;
+}
+//# sourceMappingURL=swaggerCache.d.ts.map

package/dist/utils/swaggerCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swaggerCache.d.ts","sourceRoot":"","sources":["../../src/utils/swaggerCache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,eAAe,CAAoD;IAE3E;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2BjD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI7C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQtD;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,QAAQ;;;;;IAQR;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;YACW,YAAY;CA0B3B"}

package/dist/utils/swaggerCache.js

@@ -0,0 +1,146 @@
+import axios from 'axios';
+/**
+ * Cache manager for OpenAPI documents
+ */
+export class SwaggerCache {
+    cache = new Map();
+    loadingPromises = new Map();
+    /**
+     * Loads and caches an OpenAPI document from URL
+     */
+    async load(url) {
+        // Return cached document if available
+        if (this.cache.has(url)) {
+            const cached = this.cache.get(url);
+            if (cached)
+                return cached;
+        }
+        // If already loading, return the existing promise
+        if (this.loadingPromises.has(url)) {
+            const loadingPromise = this.loadingPromises.get(url);
+            if (loadingPromise)
+                return loadingPromise;
+        }
+        // Create loading promise
+        const loadingPromise = this.fetchSwagger(url);
+        this.loadingPromises.set(url, loadingPromise);
+        try {
+            const swagger = await loadingPromise;
+            this.cache.set(url, swagger);
+            return swagger;
+        }
+        finally {
+            // Clean up loading promise
+            this.loadingPromises.delete(url);
+        }
+    }
+    /**
+     * Gets a cached OpenAPI document
+     */
+    get(url) {
+        return this.cache.get(url);
+    }
+    /**
+     * Checks if a URL is cached
+     */
+    has(url) {
+        return this.cache.has(url);
+    }
+    /**
+     * Gets an OpenAPI document, loading it if not cached
+     */
+    async getOrLoad(url) {
+        if (this.has(url)) {
+            const cached = this.get(url);
+            if (cached)
+                return cached;
+        }
+        return this.load(url);
+    }
+    /**
+     * Clears a specific URL from cache
+     */
+    clear(url) {
+        return this.cache.delete(url);
+    }
+    /**
+     * Clears all cached documents
+     */
+    clearAll() {
+        this.cache.clear();
+        this.loadingPromises.clear();
+    }
+    /**
+     * Gets cache statistics
+     */
+    getStats() {
+        return {
+            cacheSize: this.cache.size,
+            loadingPromises: this.loadingPromises.size,
+            cachedUrls: Array.from(this.cache.keys()),
+        };
+    }
+    /**
+     * Preloads multiple URLs concurrently
+     */
+    async preload(urls) {
+        const promises = urls.map(url => this.load(url).catch(error => {
+            // NOTE: error might not have message property, so we use safe access
+            console.error(`Failed to preload ${url}:`, error.message || error);
+            return null;
+        }));
+        await Promise.all(promises);
+    }
+    /**
+     * Validates that a cached document is a valid OpenAPI document
+     */
+    validateOpenAPIDocument(data, url) {
+        if (!data || typeof data !== 'object') {
+            throw new Error(`Invalid OpenAPI document: not an object (${url})`);
+        }
+        const doc = data;
+        if (!doc.openapi && !doc.swagger) {
+            throw new Error(`Invalid OpenAPI document: missing openapi/swagger version (${url})`);
+        }
+        if (!doc.info) {
+            throw new Error(`Invalid OpenAPI document: missing info section (${url})`);
+        }
+        if (!doc.paths || typeof doc.paths !== 'object') {
+            throw new Error(`Invalid OpenAPI document: missing or invalid paths section (${url})`);
+        }
+        return data;
+    }
+    /**
+     * Fetches OpenAPI document from URL with validation
+     */
+    async fetchSwagger(url) {
+        try {
+            const response = await axios.get(url, {
+                timeout: 30000, // 30 second timeout
+                headers: {
+                    Accept: 'application/json, application/yaml, text/yaml',
+                    'User-Agent': 'swagger-parser-mcp-server/1.0.0',
+                },
+            });
+            return this.validateOpenAPIDocument(response.data, url);
+        }
+        catch (error) {
+            if (error && typeof error === 'object' && 'response' in error) {
+                const axiosError = error;
+                throw new Error(`HTTP ${axiosError.response.status}: ${axiosError.response.statusText} (${url})`);
+            }
+            else if (error && typeof error === 'object' && 'request' in error) {
+                throw new Error(`Network error: Unable to fetch ${url}`);
+            }
+            else if (error && typeof error === 'object' && 'code' in error && error.code === 'ECONNABORTED') {
+                const timeoutError = error;
+                throw new Error(`Failed to load OpenAPI document: ${timeoutError.message} (${url})`);
+            }
+            else {
+                const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
+                throw new Error(`Failed to load OpenAPI document: ${errorMessage} (${url})`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=swaggerCache.js.map

package/dist/utils/swaggerCache.js.map

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

package/dist/utils/types.d.ts

@@ -0,0 +1,73 @@
+import type { OpenAPIV3 } from 'openapi-types';
+export type OpenAPIDocument = OpenAPIV3.Document;
+export type Operation = OpenAPIV3.OperationObject;
+export type Parameter = OpenAPIV3.ParameterObject;
+export type Response = OpenAPIV3.ResponseObject;
+export type Schema = OpenAPIV3.SchemaObject;
+export type PathItem = OpenAPIV3.PathItemObject;
+export type MediaType = OpenAPIV3.MediaTypeObject;
+export type RequestBody = OpenAPIV3.RequestBodyObject;
+export type ResponsesObject = OpenAPIV3.ResponsesObject;
+export type SwaggerSpec = OpenAPIV3.Document;
+export type HTTPMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options';
+export interface PathOperation {
+    path: string;
+    method: HTTPMethod;
+    operationId?: string;
+    summary?: string;
+    description?: string;
+}
+export interface ResolvedParameter {
+    name: string;
+    in: 'query' | 'header' | 'path' | 'cookie';
+    required?: boolean;
+    description?: string;
+    schema: unknown;
+}
+export interface ResolvedRequestBody {
+    required?: boolean;
+    mediaType: string;
+    schema: unknown;
+}
+export interface ResolvedResponse {
+    description: string;
+    mediaType?: string;
+    schema?: unknown;
+}
+export interface PathDetails {
+    path: string;
+    method: string;
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    parameters: ResolvedParameter[];
+    requestBody?: ResolvedRequestBody;
+    responses: Record<string, ResolvedResponse>;
+}
+export interface SchemaResolutionContext {
+    visitedRefs: Set<string>;
+    maxDepth: number;
+    currentDepth: number;
+}
+export interface ResolvedSchema {
+    $ref?: string;
+    resolved: any;
+    isCircular?: boolean;
+    circularRef?: string;
+}
+export interface SchemaResolverOptions {
+    maxDepth?: number;
+    includeCircularRefs?: boolean;
+    circularRefPlaceholder?: string;
+}
+export declare class CircularReferenceError extends Error {
+    constructor(ref: string, path: string[]);
+}
+export declare class MaxDepthExceededError extends Error {
+    constructor(maxDepth: number, ref: string);
+}
+export declare class InvalidReferenceError extends Error {
+    constructor(ref: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

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

package/dist/utils/types.js

@@ -0,0 +1,20 @@
+// Error types
+export class CircularReferenceError extends Error {
+    constructor(ref, path) {
+        super(`Circular reference detected: ${ref} (path: ${path.join(' -> ')})`);
+        this.name = 'CircularReferenceError';
+    }
+}
+export class MaxDepthExceededError extends Error {
+    constructor(maxDepth, ref) {
+        super(`Maximum resolution depth (${maxDepth}) exceeded for reference: ${ref}`);
+        this.name = 'MaxDepthExceededError';
+    }
+}
+export class InvalidReferenceError extends Error {
+    constructor(ref) {
+        super(`Invalid reference: ${ref}`);
+        this.name = 'InvalidReferenceError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAyFA,cAAc;AACd,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,GAAW,EAAE,IAAc;QACrC,KAAK,CAAC,gCAAgC,GAAG,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,QAAgB,EAAE,GAAW;QACvC,KAAK,CAAC,6BAA6B,QAAQ,6BAA6B,GAAG,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,GAAW;QACrB,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swagger-parser-mcp-server",
-  "version": "1.0.6",
+  "version": "1.1.0",
   "description": "MCP server for parsing Swagger/OpenAPI JSON files",
   "main": "dist/index.js",
   "type": "module",
@@ -15,12 +15,6 @@
     "README.md",
     "package.json"
   ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "mcp",
     "swagger",
@@ -35,11 +29,39 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.6.0",
+    "openapi-types": "^12.1.3",
+    "swagger-schema-official": "2.0.0-bab6bed",
     "zod": "^3.22.0"
   },
   "devDependencies": {
+    "@eslint/js": "^9.32.0",
+    "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
+    "@types/swagger-schema-official": "^2.0.25",
+    "eslint": "^9.32.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.3",
+    "globals": "^16.3.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.1.0",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.38.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "check-all": "pnpm run typecheck && pnpm run lint && pnpm run format:check",
+    "preinstall": "npx only-allow pnpm"
   }
-}
+}