@abhishekkumar00019/swagger-mcp 1.0.0

package/dist/parser/tool-builder.js

@@ -0,0 +1,138 @@
+/**
+ * Converts parsed OpenAPI operations into MCP tool definitions and mappings.
+ */
+export function buildTools(operations) {
+    const tools = [];
+    const mappings = new Map();
+    const usedNames = new Set();
+    for (const operation of operations) {
+        const toolName = generateToolName(operation, usedNames);
+        usedNames.add(toolName);
+        const tool = buildToolDefinition(toolName, operation);
+        tools.push(tool);
+        mappings.set(toolName, { toolName, operation });
+    }
+    return { tools, mappings };
+}
+// ─── Tool Name Generation ───────────────────────────────────────────────────
+/**
+ * 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 function generateToolName(operation, usedNames) {
+    let name;
+    if (operation.operationId) {
+        // Priority 1: use operationId directly — preserve its casing
+        name = sanitizeName(operation.operationId, false);
+    }
+    else if (operation.tag) {
+        // Priority 2: tag + method + path — lowercase
+        name = sanitizeName(`${operation.tag}_${operation.method}_${operation.path}`, true);
+    }
+    else {
+        // Priority 3: method + path — lowercase
+        name = sanitizeName(`${operation.method}_${operation.path}`, true);
+    }
+    // Guard against empty name after sanitization
+    if (!name) {
+        name = "unnamed_tool";
+    }
+    // Ensure uniqueness by appending a counter if needed
+    let uniqueName = name;
+    let counter = 2;
+    while (usedNames.has(uniqueName)) {
+        const suffix = `_${counter}`;
+        uniqueName = name.substring(0, 64 - suffix.length) + suffix;
+        counter++;
+    }
+    return uniqueName;
+}
+/**
+ * Sanitizes a string into a valid MCP tool name.
+ * - Optionally lowercase
+ * - Replace special chars with _
+ * - Collapse multiple _ into one
+ * - Strip leading/trailing _
+ * - Max 64 characters
+ */
+function sanitizeName(raw, forceLowercase) {
+    let name = raw;
+    if (forceLowercase) {
+        name = name.toLowerCase();
+    }
+    return name
+        .replace(/[^a-zA-Z0-9_]/g, "_") // replace invalid chars with _
+        .replace(/_+/g, "_") // collapse multiple _
+        .replace(/^_|_$/g, "") // strip leading/trailing _
+        .substring(0, 64);
+}
+// ─── Tool Definition Building ───────────────────────────────────────────────
+/**
+ * Builds a full MCP tool definition from an operation.
+ */
+function buildToolDefinition(toolName, operation) {
+    // Build description: [METHOD /path] — summary — description
+    const descParts = [];
+    descParts.push(`[${operation.method.toUpperCase()} ${operation.path}]`);
+    if (operation.summary)
+        descParts.push(operation.summary);
+    if (operation.description && operation.description !== operation.summary) {
+        descParts.push(operation.description);
+    }
+    const description = descParts.join(" — ");
+    // Build input schema
+    const properties = {};
+    const requiredSet = new Set();
+    // Add parameters (path, query, header)
+    for (const param of operation.parameters) {
+        // Skip cookie params — rarely used with MCP
+        if (param.in === "cookie")
+            continue;
+        // Check for collision with the reserved "body" property name
+        const propName = param.name === "body" && operation.requestBody
+            ? "body_param"
+            : param.name;
+        const propSchema = { ...param.schema };
+        // Enrich description with parameter location info
+        const descPieces = [];
+        if (param.description)
+            descPieces.push(param.description);
+        descPieces.push(`(${param.in} parameter)`);
+        propSchema.description = descPieces.join(" ");
+        properties[propName] = propSchema;
+        if (param.required) {
+            requiredSet.add(propName);
+        }
+    }
+    // Add request body
+    if (operation.requestBody) {
+        const bodySchema = {
+            ...operation.requestBody.schema,
+        };
+        if (operation.requestBody.description) {
+            bodySchema.description = operation.requestBody.description;
+        }
+        properties["body"] = bodySchema;
+        if (operation.requestBody.required) {
+            requiredSet.add("body");
+        }
+    }
+    const required = [...requiredSet];
+    return {
+        name: toolName,
+        description,
+        inputSchema: {
+            type: "object",
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+        },
+    };
+}
+//# sourceMappingURL=tool-builder.js.map

package/dist/parser/tool-builder.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,19 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { ServerConfig } from "./core/types.js";
+/**
+ * Creates and configures the MCP server.
+ *
+ * Flow:
+ * 1. Fetch & parse the Swagger spec
+ * 2. Resolve the base URL (config → spec → spec URL origin)
+ * 3. Generate MCP tool definitions from operations
+ * 4. Register ListTools and CallTool handlers
+ */
+export declare function createServer(config: ServerConfig): Promise<Server>;
+/**
+ * Resolves the base URL from 3 sources (priority order):
+ * 1. Explicit override from config
+ * 2. Base URL extracted from the spec
+ * 3. Origin of the spec URL itself
+ */
+export declare function resolveBaseUrl(specUrl: string, configBaseUrl?: string, specBaseUrl?: string): string;

package/dist/server.js

@@ -0,0 +1,175 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { parseSwaggerSpec } from "./parser/swagger-parser.js";
+import { buildTools } from "./parser/tool-builder.js";
+import { executeToolRequest } from "./http/request-handler.js";
+/**
+ * Creates and configures the MCP server.
+ *
+ * Flow:
+ * 1. Fetch & parse the Swagger spec
+ * 2. Resolve the base URL (config → spec → spec URL origin)
+ * 3. Generate MCP tool definitions from operations
+ * 4. Register ListTools and CallTool handlers
+ */
+export async function createServer(config) {
+    // ─── Parse the spec ─────────────────────────────────────────────────
+    let tools;
+    let mappings;
+    let baseUrl;
+    let apiTitle;
+    const result = await loadSpec(config);
+    tools = result.tools;
+    mappings = result.mappings;
+    baseUrl = result.baseUrl;
+    apiTitle = result.apiTitle;
+    // ─── Create MCP server ─────────────────────────────────────────────
+    const server = new Server({
+        name: `swagger-mcp: ${apiTitle}`,
+        version: "1.0.0",
+    }, {
+        capabilities: { tools: {} },
+    });
+    // ─── ListTools handler ─────────────────────────────────────────────
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        // Include the reload meta-tool
+        const allTools = [
+            ...tools,
+            {
+                name: "_swagger_mcp_reload",
+                description: "Re-fetches and re-parses the Swagger/OpenAPI spec to update all tools. " +
+                    "Use this if the API spec has changed and you want to pick up new endpoints.",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+        ];
+        return { tools: allTools };
+    });
+    // ─── CallTool handler ──────────────────────────────────────────────
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        // Handle the reload meta-tool
+        if (name === "_swagger_mcp_reload") {
+            console.error("[swagger-mcp] Reloading spec...");
+            try {
+                const reloaded = await loadSpec(config);
+                tools = reloaded.tools;
+                mappings = reloaded.mappings;
+                baseUrl = reloaded.baseUrl;
+                apiTitle = reloaded.apiTitle;
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Successfully reloaded spec. Found ${tools.length} tools from "${apiTitle}".`,
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        { type: "text", text: `Failed to reload spec: ${message}` },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        // Look up the tool mapping
+        const mapping = mappings.get(name);
+        if (!mapping) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown tool: "${name}". Use ListTools to see available tools.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Execute the HTTP request with catch-all error handling
+        try {
+            const result = await executeToolRequest(mapping, (args || {}), config, baseUrl);
+            return {
+                content: [{ type: "text", text: result.content }],
+                isError: result.isError,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unexpected error executing tool "${name}": ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+/**
+ * Loads the spec, builds tools, and resolves the base URL.
+ */
+async function loadSpec(config) {
+    const { operations, specBaseUrl, title } = await parseSwaggerSpec(config.specUrl);
+    const { tools, mappings } = buildTools(operations);
+    // Resolve base URL with 3-tier priority:
+    // 1. Config override (env var / CLI arg)
+    // 2. Spec's servers[0].url or host+basePath
+    // 3. Origin of the spec URL
+    const baseUrl = resolveBaseUrl(config.specUrl, config.baseUrl, specBaseUrl);
+    console.error(`[swagger-mcp] Base URL: ${baseUrl}`);
+    console.error(`[swagger-mcp] Registered ${tools.length} tools:`);
+    for (const tool of tools) {
+        console.error(`  - ${tool.name}`);
+    }
+    return { tools, mappings, baseUrl, apiTitle: title };
+}
+/**
+ * Resolves the base URL from 3 sources (priority order):
+ * 1. Explicit override from config
+ * 2. Base URL extracted from the spec
+ * 3. Origin of the spec URL itself
+ */
+export function resolveBaseUrl(specUrl, configBaseUrl, specBaseUrl) {
+    // Priority 1: explicit config
+    if (configBaseUrl) {
+        return configBaseUrl.replace(/\/+$/, "");
+    }
+    // Priority 2: from spec
+    if (specBaseUrl) {
+        // specBaseUrl might be a relative path (OpenAPI 3.x allows this)
+        if (specBaseUrl.startsWith("http://") ||
+            specBaseUrl.startsWith("https://")) {
+            return specBaseUrl.replace(/\/+$/, "");
+        }
+        // Relative path — combine with spec URL origin
+        try {
+            const origin = new URL(specUrl).origin;
+            return `${origin}${specBaseUrl}`.replace(/\/+$/, "");
+        }
+        catch {
+            // specUrl might be a file path — can't extract origin
+            return specBaseUrl.replace(/\/+$/, "");
+        }
+    }
+    // Priority 3: origin of the spec URL
+    try {
+        const parsed = new URL(specUrl);
+        return parsed.origin;
+    }
+    catch {
+        console.error("[swagger-mcp] Warning: Could not derive base URL. " +
+            "Please provide SWAGGER_MCP_BASE_URL explicitly.");
+        // Return a clearly broken URL so errors are obvious
+        return "http://localhost";
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAqB,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAoB;IACrD,uEAAuE;IACvE,IAAI,KAA0B,CAAC;IAC/B,IAAI,QAAkC,CAAC;IACvC,IAAI,OAAe,CAAC;IACpB,IAAI,QAAgB,CAAC;IAErB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACrB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC3B,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACzB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAE3B,sEAAsE;IACtE,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,gBAAgB,QAAQ,EAAE;QAChC,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;KAC5B,CACF,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,+BAA+B;QAC/B,MAAM,QAAQ,GAAwB;YACpC,GAAG,KAAK;YACR;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EACT,yEAAyE;oBACzE,6EAA6E;gBAC/E,WAAW,EAAE;oBACX,IAAI,EAAE,QAAiB;oBACvB,UAAU,EAAE,EAAE;iBACf;aACF;SACF,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,sEAAsE;IACtE,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,8BAA8B;QAC9B,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACjD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACxC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;gBACvB,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;gBAC7B,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;gBAC3B,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;gBAE7B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,qCAAqC,KAAK,CAAC,MAAM,gBAAgB,QAAQ,IAAI;yBACpF;qBACF;iBACF,CAAC;YACJ,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACzD,OAAO;oBACL,OAAO,EAAE;wBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,OAAO,EAAE,EAAE;qBACrE;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kBAAkB,IAAI,0CAA0C;qBACvE;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,yDAAyD;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC,OAAO,EACP,CAAC,IAAI,IAAI,EAAE,CAA4B,EACvC,MAAM,EACN,OAAO,CACR,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC1D,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,oCAAoC,IAAI,MAAM,OAAO,EAAE;qBAC9D;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,QAAQ,CAAC,MAAoB;IAM1C,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,MAAM,gBAAgB,CAC/D,MAAM,CAAC,OAAO,CACf,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IAEnD,yCAAyC;IACzC,yCAAyC;IACzC,4CAA4C;IAC5C,4BAA4B;IAC5B,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAE5E,OAAO,CAAC,KAAK,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,KAAK,CAAC,4BAA4B,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC;IACjE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,aAAsB,EACtB,WAAoB;IAEpB,8BAA8B;IAC9B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,wBAAwB;IACxB,IAAI,WAAW,EAAE,CAAC;QAChB,iEAAiE;QACjE,IACE,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;YACjC,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAClC,CAAC;YACD,OAAO,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACvC,OAAO,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;YACtD,OAAO,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CACX,oDAAoD;YAClD,iDAAiD,CACpD,CAAC;QACF,oDAAoD;QACpD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@abhishekkumar00019/swagger-mcp",
+  "version": "1.0.0",
+  "description": "Dynamic MCP server that converts Swagger/OpenAPI specs into callable MCP tools",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "swagger-mcp": "dist/index.js",
+    "@abhishekkumar00019/swagger-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itachiuchihadev/swagger-mcp.git"
+  },
+  "author": "Abhishek Kumar",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run test && npm run build",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "mcp",
+    "swagger",
+    "openapi",
+    "model-context-protocol",
+    "ai-tools",
+    "claude",
+    "copilot",
+    "cursor"
+  ],
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.1",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "openapi-types": "^12.1.3",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.34",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.10"
+  }
+}