@abhishekkumar00019/swagger-mcp 1.0.0

package/dist/http/request-handler.js

@@ -0,0 +1,167 @@
+import { getAuthHeaders } from "./auth.js";
+/**
+ * Executes an HTTP request for a tool invocation.
+ *
+ * Takes the tool mapping (which knows the operation details) and the
+ * arguments provided by the LLM, builds the full HTTP request, executes it,
+ * and returns the response as a string.
+ */
+export async function executeToolRequest(mapping, args, config, baseUrl) {
+    const { operation } = mapping;
+    try {
+        // 1. Validate required path parameters are present
+        const missingPathParams = operation.parameters
+            .filter((p) => p.in === "path" && p.required && args[p.name] === undefined)
+            .map((p) => p.name);
+        if (missingPathParams.length > 0) {
+            return {
+                content: `Missing required path parameter(s): ${missingPathParams.join(", ")}`,
+                isError: true,
+            };
+        }
+        // 2. Build the URL with path parameters substituted
+        let url = buildUrl(baseUrl, operation.path, args, operation.parameters);
+        // 3. Append query parameters
+        url = appendQueryParams(url, args, operation.parameters);
+        // 4. Build headers
+        const headers = {
+            Accept: "application/json",
+            ...config.defaultHeaders,
+            ...getAuthHeaders(config.auth),
+        };
+        // Add header parameters from args
+        for (const param of operation.parameters) {
+            if (param.in === "header" && args[param.name] !== undefined) {
+                headers[param.name] = String(args[param.name]);
+            }
+        }
+        // 5. Build request body (for methods that support it)
+        let body;
+        if (args.body !== undefined && ["post", "put", "patch", "delete"].includes(operation.method)) {
+            headers["Content-Type"] =
+                operation.requestBody?.contentType || "application/json";
+            body =
+                typeof args.body === "string"
+                    ? args.body
+                    : JSON.stringify(args.body);
+        }
+        // 6. Execute the request
+        console.error(`[swagger-mcp] ${operation.method.toUpperCase()} ${url}`);
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), config.timeout);
+        try {
+            const response = await fetch(url, {
+                method: operation.method.toUpperCase(),
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            // 7. Process response
+            const responseText = await response.text();
+            if (!response.ok) {
+                return {
+                    content: formatErrorResponse(response.status, response.statusText, responseText),
+                    isError: true,
+                };
+            }
+            return {
+                content: formatSuccessResponse(response.status, responseText),
+                isError: false,
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    catch (error) {
+        // Use standard AbortError detection instead of string matching
+        if (error instanceof Error && error.name === "AbortError") {
+            return {
+                content: `Request timed out after ${config.timeout}ms`,
+                isError: true,
+            };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: `Request failed: ${message}`,
+            isError: true,
+        };
+    }
+}
+/**
+ * Builds the full URL by substituting path parameters into the template.
+ * Uses replaceAll to handle duplicate path params (e.g. /users/{id}/friends/{id}).
+ */
+function buildUrl(baseUrl, pathTemplate, args, parameters) {
+    let resolvedPath = pathTemplate;
+    // Substitute path parameters: /users/{id} → /users/123
+    for (const param of parameters) {
+        if (param.in === "path" && args[param.name] !== undefined) {
+            resolvedPath = resolvedPath.replaceAll(`{${param.name}}`, encodeURIComponent(String(args[param.name])));
+        }
+    }
+    // Ensure no double slashes between baseUrl and path
+    const cleanBase = baseUrl.replace(/\/+$/, "");
+    const cleanPath = resolvedPath.startsWith("/")
+        ? resolvedPath
+        : `/${resolvedPath}`;
+    return `${cleanBase}${cleanPath}`;
+}
+/**
+ * Appends query parameters to the URL.
+ * Skips null/undefined values to prevent sending "null" as a string.
+ */
+function appendQueryParams(url, args, parameters) {
+    const queryParams = new URLSearchParams();
+    for (const param of parameters) {
+        if (param.in === "query" && args[param.name] != null) {
+            const value = args[param.name];
+            if (Array.isArray(value)) {
+                // Handle array query params
+                for (const item of value) {
+                    if (item != null) {
+                        queryParams.append(param.name, String(item));
+                    }
+                }
+            }
+            else {
+                queryParams.set(param.name, String(value));
+            }
+        }
+    }
+    const queryString = queryParams.toString();
+    if (!queryString)
+        return url;
+    const separator = url.includes("?") ? "&" : "?";
+    return `${url}${separator}${queryString}`;
+}
+/**
+ * Formats a successful response for the MCP tool result.
+ */
+function formatSuccessResponse(status, body) {
+    let formattedBody;
+    try {
+        const parsed = JSON.parse(body);
+        formattedBody = JSON.stringify(parsed, null, 2);
+    }
+    catch {
+        formattedBody = body;
+    }
+    return `HTTP ${status}\n\n${formattedBody}`;
+}
+/**
+ * Formats an error response for the MCP tool result.
+ */
+function formatErrorResponse(status, statusText, body) {
+    let formattedBody;
+    try {
+        const parsed = JSON.parse(body);
+        formattedBody = JSON.stringify(parsed, null, 2);
+    }
+    catch {
+        formattedBody = body;
+    }
+    return `HTTP ${status} ${statusText}\n\n${formattedBody}`;
+}
+//# sourceMappingURL=request-handler.js.map

package/dist/http/request-handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./core/config.js";
+import { createServer } from "./server.js";
+/**
+ * Entry point for the swagger-mcp server.
+ *
+ * Loads configuration, creates the MCP server, and connects it
+ * to stdio transport for communication with MCP clients.
+ */
+async function main() {
+    console.error("[swagger-mcp] Starting...");
+    // Load configuration from env vars and CLI args
+    const config = loadConfig();
+    console.error(`[swagger-mcp] Spec URL: ${config.specUrl}`);
+    try {
+        // Create the MCP server (fetches spec, builds tools)
+        const server = await createServer(config);
+        // Connect via stdio transport
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("[swagger-mcp] Server is running. Waiting for requests...");
+        // Handle graceful shutdown
+        const shutdown = async () => {
+            console.error("[swagger-mcp] Shutting down...");
+            await server.close();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[swagger-mcp] Fatal error: ${message}`);
+        if (error instanceof Error && error.stack) {
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+}
+// Safety nets for unhandled errors in the stdio server process
+process.on("unhandledRejection", (reason) => {
+    console.error("[swagger-mcp] Unhandled rejection:", reason);
+});
+process.on("uncaughtException", (error) => {
+    console.error("[swagger-mcp] Uncaught exception:", error);
+    process.exit(1);
+});
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;GAKG;AACH,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAE3C,gDAAgD;IAChD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,qDAAqD;QACrD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;QAE1C,8BAA8B;QAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAE1E,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAChD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;QACvD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,MAAM,CAAC,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC"}

package/dist/parser/swagger-parser.d.ts

@@ -0,0 +1,20 @@
+import { ParsedOperation } from "../core/types.js";
+/**
+ * Fetches and parses a Swagger/OpenAPI spec from a URL or file path.
+ * Supports both Swagger 2.0 and OpenAPI 3.x.
+ * Returns parsed operations and the resolved base URL from the spec.
+ */
+export declare function parseSwaggerSpec(specUrl: string): Promise<{
+    operations: ParsedOperation[];
+    specBaseUrl: string | undefined;
+    title: string;
+    version: string;
+}>;
+/**
+ * Sanitizes a schema object for use as a JSON Schema in MCP tools.
+ * Removes OpenAPI-specific extensions and null/undefined values.
+ *
+ * Uses a WeakSet to track visited objects and prevent infinite loops
+ * on circular references (which SwaggerParser.dereference() can create).
+ */
+export declare function sanitizeSchema(schema: Record<string, unknown>, visited?: WeakSet<object>): Record<string, unknown>;

package/dist/parser/swagger-parser.js

@@ -0,0 +1,262 @@
+import SwaggerParser from "@apidevtools/swagger-parser";
+import { HTTP_METHODS, } from "../core/types.js";
+/**
+ * Fetches and parses a Swagger/OpenAPI spec from a URL or file path.
+ * Supports both Swagger 2.0 and OpenAPI 3.x.
+ * Returns parsed operations and the resolved base URL from the spec.
+ */
+export async function parseSwaggerSpec(specUrl) {
+    console.error(`[swagger-mcp] Fetching spec from: ${specUrl}`);
+    let api;
+    try {
+        // Dereference resolves all $ref pointers so we get a flat object
+        api = await SwaggerParser.dereference(specUrl);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to fetch or parse OpenAPI spec from "${specUrl}": ${message}`);
+    }
+    const title = api.info?.title || "Unknown API";
+    const version = api.info?.version || "0.0.0";
+    console.error(`[swagger-mcp] Parsed: ${title} v${version}`);
+    const specBaseUrl = extractBaseUrl(api);
+    const operations = extractOperations(api);
+    console.error(`[swagger-mcp] Found ${operations.length} operations`);
+    return { operations, specBaseUrl, title, version };
+}
+/**
+ * Extracts the base URL from the spec.
+ * - OpenAPI 3.x: uses servers[0].url
+ * - Swagger 2.0: uses host + basePath + schemes
+ */
+function extractBaseUrl(api) {
+    // OpenAPI 3.x
+    if ("openapi" in api && api.openapi?.startsWith("3")) {
+        const doc = api;
+        if (doc.servers && doc.servers.length > 0) {
+            return doc.servers[0].url;
+        }
+        return undefined;
+    }
+    // Swagger 2.0
+    if ("swagger" in api) {
+        const doc = api;
+        if (doc.host) {
+            const scheme = doc.schemes && doc.schemes.length > 0 ? doc.schemes[0] : "https";
+            const basePath = doc.basePath || "";
+            return `${scheme}://${doc.host}${basePath}`;
+        }
+        return undefined;
+    }
+    return undefined;
+}
+/**
+ * Extracts all operations from the spec into ParsedOperation objects.
+ */
+function extractOperations(api) {
+    const operations = [];
+    if (!api.paths)
+        return operations;
+    const isV3 = "openapi" in api;
+    for (const [path, pathItem] of Object.entries(api.paths)) {
+        if (!pathItem)
+            continue;
+        // Path-level parameters (shared by all operations on this path)
+        const pathLevelParams = extractPathLevelParams(pathItem);
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation || typeof operation !== "object")
+                continue;
+            const op = operation;
+            // Parse operation-level parameters, filtering out body params for Swagger 2.0
+            // (body params are handled separately in parseRequestBody)
+            const rawOperationParams = parseParameters(op.parameters || []);
+            const operationParams = rawOperationParams.filter((p) => p.in !== "body");
+            // Merge path-level and operation-level parameters
+            const mergedParams = mergeParameters(pathLevelParams, operationParams);
+            // Parse request body
+            const requestBody = parseRequestBody(op, api);
+            // Extract tag
+            const tags = op.tags;
+            const tag = tags && tags.length > 0 ? tags[0] : undefined;
+            operations.push({
+                operationId: op.operationId,
+                method,
+                path,
+                tag,
+                summary: op.summary,
+                description: op.description,
+                parameters: mergedParams,
+                requestBody,
+            });
+        }
+    }
+    return operations;
+}
+/**
+ * Extracts path-level parameters from a path item.
+ * Filters out body and formData params (handled separately).
+ */
+function extractPathLevelParams(pathItem) {
+    const params = pathItem.parameters;
+    if (!Array.isArray(params))
+        return [];
+    return parseParameters(params).filter((p) => p.in !== "body");
+}
+/**
+ * Parses parameter objects into ParsedParameter[].
+ * Handles both Swagger 2.0 and OpenAPI 3.x parameter formats.
+ */
+function parseParameters(params) {
+    return params
+        .filter((p) => p !== null && typeof p === "object")
+        .filter((param) => {
+        // Skip formData params — they're used for file uploads and
+        // don't map cleanly to JSON-based MCP tool inputs
+        const paramIn = param.in;
+        return paramIn !== "formData";
+    })
+        .map((param) => {
+        // Swagger 2.0: type is directly on the param
+        // OpenAPI 3.x: type is in param.schema
+        let schema = {};
+        if (param.schema && typeof param.schema === "object") {
+            // OpenAPI 3.x
+            schema = sanitizeSchema(param.schema);
+        }
+        else if (param.type) {
+            // Swagger 2.0
+            const schemaObj = {
+                type: param.type,
+            };
+            if (param.format)
+                schemaObj.format = param.format;
+            if (param.enum)
+                schemaObj.enum = param.enum;
+            if (param.default !== undefined)
+                schemaObj.default = param.default;
+            if (param.items && typeof param.items === "object") {
+                schemaObj.items = sanitizeSchema(param.items);
+            }
+            schema = sanitizeSchema(schemaObj);
+        }
+        return {
+            name: param.name,
+            in: param.in,
+            description: param.description,
+            required: param.required || false,
+            schema,
+        };
+    });
+}
+/**
+ * Parses request body from an operation.
+ * Handles both Swagger 2.0 (body parameter) and OpenAPI 3.x (requestBody).
+ */
+function parseRequestBody(operation, api) {
+    // OpenAPI 3.x: requestBody object
+    if ("openapi" in api && operation.requestBody) {
+        const rb = operation.requestBody;
+        const content = rb.content;
+        if (content) {
+            // Prefer application/json, fall back to first content type
+            const contentType = content["application/json"]
+                ? "application/json"
+                : Object.keys(content)[0];
+            if (contentType) {
+                const mediaType = content[contentType];
+                const schema = mediaType?.schema;
+                return {
+                    description: rb.description,
+                    required: rb.required || false,
+                    schema: schema ? sanitizeSchema(schema) : { type: "object" },
+                    contentType,
+                };
+            }
+        }
+        return undefined;
+    }
+    // Swagger 2.0: look for a parameter with in: "body"
+    const params = operation.parameters;
+    if (params) {
+        const bodyParam = params.find((p) => p !== null &&
+            typeof p === "object" &&
+            p.in === "body");
+        if (bodyParam) {
+            const schema = bodyParam.schema;
+            return {
+                description: bodyParam.description,
+                required: bodyParam.required || false,
+                schema: schema ? sanitizeSchema(schema) : { type: "object" },
+                contentType: "application/json",
+            };
+        }
+    }
+    return undefined;
+}
+/**
+ * Merge path-level and operation-level parameters.
+ * Operation params override path-level params with the same name+in.
+ */
+function mergeParameters(pathParams, operationParams) {
+    const merged = new Map();
+    for (const p of pathParams) {
+        merged.set(`${p.in}:${p.name}`, p);
+    }
+    for (const p of operationParams) {
+        merged.set(`${p.in}:${p.name}`, p);
+    }
+    return Array.from(merged.values());
+}
+/**
+ * Sanitizes a schema object for use as a JSON Schema in MCP tools.
+ * Removes OpenAPI-specific extensions and null/undefined values.
+ *
+ * Uses a WeakSet to track visited objects and prevent infinite loops
+ * on circular references (which SwaggerParser.dereference() can create).
+ */
+export function sanitizeSchema(schema, visited = new WeakSet()) {
+    // Circular reference guard
+    if (visited.has(schema)) {
+        return { type: "object", description: "(circular reference)" };
+    }
+    visited.add(schema);
+    const result = {};
+    for (const [key, value] of Object.entries(schema)) {
+        // Skip OpenAPI-specific extensions and undefined/null values
+        if (key.startsWith("x-") || value === undefined || value === null)
+            continue;
+        // Skip XML definitions
+        if (key === "xml")
+            continue;
+        if (key === "properties" && typeof value === "object" && value !== null) {
+            // Recursively sanitize nested property schemas
+            const props = {};
+            for (const [propName, propSchema] of Object.entries(value)) {
+                if (propSchema && typeof propSchema === "object") {
+                    props[propName] = sanitizeSchema(propSchema, visited);
+                }
+                else {
+                    props[propName] = propSchema;
+                }
+            }
+            result[key] = props;
+        }
+        else if (key === "items" &&
+            typeof value === "object" &&
+            value !== null) {
+            // Recursively sanitize array items schema
+            result[key] = sanitizeSchema(value, visited);
+        }
+        else if (key === "additionalProperties" &&
+            typeof value === "object" &&
+            value !== null) {
+            result[key] = sanitizeSchema(value, visited);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=swagger-parser.js.map

package/dist/parser/swagger-parser.js.map

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

package/dist/parser/tool-builder.d.ts

@@ -0,0 +1,29 @@
+import { ParsedOperation, ToolMapping } from "../core/types.js";
+/**
+ * Converts parsed OpenAPI operations into MCP tool definitions and mappings.
+ */
+export declare function buildTools(operations: ParsedOperation[]): {
+    tools: McpToolDefinition[];
+    mappings: Map<string, ToolMapping>;
+};
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * Generates a unique MCP tool name for an operation.
+ *
+ * Priority:
+ * 1. operationId (if present in the spec) — preserves casing
+ * 2. tag + method + path (if tag exists) — lowercased
+ * 3. method + path (last resort) — lowercased
+ *
+ * Sanitization: replace special chars with _, collapse multiples,
+ * strip leading/trailing _, max 64 chars.
+ */
+export declare function generateToolName(operation: ParsedOperation, usedNames: Set<string>): string;