@abhishekkumar00019/swagger-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Abhishek Kumar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,314 @@
+# @abhishekkumar00019/swagger-mcp
+
+[![npm version](https://img.shields.io/npm/v/@abhishekkumar00019/swagger-mcp.svg)](https://www.npmjs.com/package/@abhishekkumar00019/swagger-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)
+
+> A dynamic [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that converts any Swagger 2.0 or OpenAPI 3.x specification into callable MCP tools on the fly.
+
+Point it at any OpenAPI/Swagger JSON or YAML spec URL, and every API endpoint automatically becomes an interactive tool for Claude, Copilot, ChatGPT, Cursor, Windsurf, and other MCP-enabled clients.
+
+---
+
+## ✨ Features
+
+- 🔄 **Dynamic Tool Generation** — Automatically parses Swagger 2.0 & OpenAPI 3.x specs at startup.
+- 🛠️ **Zero Boilerplate** — Give it a spec URL and every endpoint is instantly exposed as an MCP tool.
+- 🔐 **Flexible Auth Support** — Bearer Tokens, API Keys, and Basic Auth configured effortlessly via env vars or CLI flags.
+- 🌐 **Smart Base URL Resolution** — Auto-derives base URL from config → spec server definition → spec origin URL.
+- 🔁 **Hot Reloading** — Re-fetch and re-parse the spec live at runtime using the `_swagger_mcp_reload` tool.
+- 📝 **Rich Schemas & Descriptions** — Translates OpenAPI parameters and request bodies into strict JSON schemas for precise LLM tool calling.
+- ⏱️ **Configurable Timeouts & Custom Headers** — Easily set custom request headers and request timeout thresholds.
+
+---
+
+## 🚀 Quick Start
+
+### Option A: Direct via `npx` (No Installation Required)
+
+```bash
+SWAGGER_MCP_SPEC_URL=https://petstore.swagger.io/v2/swagger.json npx @abhishekkumar00019/swagger-mcp
+```
+
+### Option B: Global NPM Installation
+
+```bash
+npm install -g @abhishekkumar00019/swagger-mcp
+
+SWAGGER_MCP_SPEC_URL=https://petstore.swagger.io/v2/swagger.json swagger-mcp
+```
+
+### Option C: Local Repository Setup
+
+1. **Clone & Install Dependencies:**
+   ```bash
+   git clone https://github.com/itachiuchihadev/swagger-mcp.git
+   cd swagger-mcp
+   npm install
+   ```
+
+2. **Build the Project:**
+   ```bash
+   npm run build
+   ```
+
+3. **Run locally:**
+   ```bash
+   SWAGGER_MCP_SPEC_URL=https://petstore.swagger.io/v2/swagger.json node dist/index.js
+   ```
+
+---
+
+## ⚙️ MCP Client Configurations
+
+Below are sample configurations for popular MCP clients using `npx @abhishekkumar00019/swagger-mcp`.
+
+### 1. Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "swagger-mcp": {
+      "command": "npx",
+      "args": ["-y", "@abhishekkumar00019/swagger-mcp"],
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json",
+        "SWAGGER_MCP_BEARER_TOKEN": "your-api-token-here"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 2. Claude Code (CLI)
+
+Add directly via the Claude Code CLI:
+
+```bash
+claude mcp add swagger-mcp -- npx -y @abhishekkumar00019/swagger-mcp --spec-url https://petstore.swagger.io/v2/swagger.json
+```
+
+Or add to `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "swagger-mcp": {
+      "command": "npx",
+      "args": ["-y", "@abhishekkumar00019/swagger-mcp"],
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 3. GitHub Copilot / VS Code
+
+Add to `.vscode/mcp.json` in your workspace or global VS Code settings:
+
+```json
+{
+  "mcpServers": {
+    "swagger-mcp": {
+      "command": "npx",
+      "args": ["-y", "@abhishekkumar00019/swagger-mcp"],
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json",
+        "SWAGGER_MCP_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 4. Cursor
+
+Add to `.cursor/mcp.json` or configure in **Cursor Settings → Features → MCP**:
+
+```json
+{
+  "mcpServers": {
+    "swagger-mcp": {
+      "command": "npx",
+      "args": ["-y", "@abhishekkumar00019/swagger-mcp"],
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 5. Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "swagger-mcp": {
+      "command": "npx",
+      "args": ["-y", "@abhishekkumar00019/swagger-mcp"],
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 6. Roo Code / Cline (VS Code Extension)
+
+Add to `cline_mcp_settings.json` (or `roo_code_mcp_settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "swagger-mcp": {
+      "command": "npx",
+      "args": ["-y", "@abhishekkumar00019/swagger-mcp"],
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 7. ChatGPT & OpenAI (Custom GPTs / Assistants / API)
+
+**Direct OpenAPI Spec Import (Native Custom GPT Actions):**
+ChatGPT Custom GPTs support OpenAPI specifications natively. You can directly import your Swagger/OpenAPI JSON/YAML spec URL in the **Actions** section of the Custom GPT Builder without needing an intermediate server.
+
+**Via MCP HTTP/SSE Gateway:**
+If connecting ChatGPT or OpenAI agents to this MCP server via an HTTP/SSE bridge (e.g., using `supergateway` or `mcp-remote`), start `swagger-mcp` with an SSE proxy:
+
+```bash
+npx supergateway --stdio "npx -y @abhishekkumar00019/swagger-mcp --spec-url https://petstore.swagger.io/v2/swagger.json" --port 8000
+```
+
+---
+
+### 8. Zed Editor
+
+Add to `~/.config/zed/settings.json`:
+
+```json
+{
+  "context_servers": {
+    "swagger-mcp": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@abhishekkumar00019/swagger-mcp"]
+      },
+      "env": {
+        "SWAGGER_MCP_SPEC_URL": "https://petstore.swagger.io/v2/swagger.json"
+      }
+    }
+  }
+}
+```
+
+---
+
+## 🔧 Configuration Reference
+
+All configuration parameters can be supplied via environment variables or CLI arguments. **`SWAGGER_MCP_SPEC_URL` is the only required parameter.**
+
+| Environment Variable | CLI Argument | Required | Default | Description |
+|---|---|---|---|---|
+| `SWAGGER_MCP_SPEC_URL` | `--spec-url` | Yes | — | Swagger/OpenAPI spec URL |
+| `SWAGGER_MCP_BASE_URL` | `--base-url` | No | Auto-derived | Override target API base URL |
+| `SWAGGER_MCP_BEARER_TOKEN` | `--bearer-token` | No | — | Bearer token for `Authorization: Bearer <token>` |
+| `SWAGGER_MCP_API_KEY` | `--api-key` | No | — | API Key header value |
+| `SWAGGER_MCP_API_KEY_HEADER` | `--api-key-header` | No | `X-API-Key` | Custom header name for API Key |
+| `SWAGGER_MCP_BASIC_USER` | `--basic-user` | No | — | Username for Basic Auth |
+| `SWAGGER_MCP_BASIC_PASS` | `--basic-pass` | No | — | Password for Basic Auth |
+| `SWAGGER_MCP_TIMEOUT` | `--timeout` | No | `30000` | HTTP request timeout in milliseconds |
+| `SWAGGER_MCP_HEADERS` | `--headers` | No | `{}` | Extra HTTP headers as JSON string |
+
+---
+
+### 🔑 Authentication Examples
+
+Multiple authentication methods can be set simultaneously:
+
+```bash
+# Bearer Token
+SWAGGER_MCP_BEARER_TOKEN=sk-your-token-here
+
+# API Key (Custom Header)
+SWAGGER_MCP_API_KEY=your-api-key
+SWAGGER_MCP_API_KEY_HEADER=X-Custom-Key
+
+# Basic Auth
+SWAGGER_MCP_BASIC_USER=admin
+SWAGGER_MCP_BASIC_PASS=secret123
+```
+
+> [!NOTE]
+> If both Bearer and Basic Auth are specified, Basic Auth will overwrite the `Authorization` header. Combine Bearer Token with API Key headers if multiple headers are required.
+
+---
+
+## 🏷️ Tool Naming Strategy
+
+Endpoints from your OpenAPI spec are converted into MCP tools using the following priority order:
+
+| Priority | Source | Example |
+|---|---|---|
+| **1st** | `operationId` defined in spec | `getUserById` |
+| **2nd** | Tag + Method + Path | `users_get_by_id` |
+| **3rd** | Method + Path | `get_api_v1_users_by_id` |
+
+---
+
+## 🧰 Built-in Meta Tools
+
+| Tool | Description |
+|---|---|
+| `_swagger_mcp_reload` | Re-fetches and parses the Swagger spec live. Useful when developing or updating APIs without restarting the server. |
+
+---
+
+## 📁 Project Structure
+
+```text
+swagger-mcp/
+├── package.json
+├── tsconfig.json
+├── src/
+│   ├── index.ts              # Entry point & CLI argument parser
+│   ├── server.ts             # MCP server initialization & tool registration
+│   ├── swagger-parser.ts     # OpenAPI 2.0/3.x spec fetcher & parser
+│   ├── tool-builder.ts       # Converts OpenAPI operations -> JSON Schema tools
+│   ├── request-handler.ts    # Proxies MCP tool calls to HTTP endpoints
+│   ├── auth.ts               # Authentication header builder
+│   ├── config.ts             # Environment & CLI configuration manager
+│   └── types.ts              # Shared TypeScript interfaces
+└── dist/                     # Compiled JavaScript output
+```
+
+---
+
+## 📄 License
+
+[MIT](LICENSE)

package/dist/core/config.d.ts

@@ -0,0 +1,21 @@
+import { ServerConfig } from "./types.js";
+/**
+ * Loads server configuration from environment variables and CLI arguments.
+ *
+ * Priority: CLI args override env vars.
+ * Only SWAGGER_MCP_SPEC_URL is required — everything else is optional.
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Builds a ServerConfig from explicit values (useful for testing and programmatic use).
+ * Applies defaults for optional fields.
+ */
+export declare function buildConfig(overrides: Partial<ServerConfig> & {
+    specUrl: string;
+}): ServerConfig;
+/**
+ * Simple CLI argument parser.
+ * Supports: --key value and --key=value
+ * Returns a Record<string, string>.
+ */
+export declare function parseCliArgs(argv: string[]): Record<string, string>;

package/dist/core/config.js

@@ -0,0 +1,91 @@
+/**
+ * Loads server configuration from environment variables and CLI arguments.
+ *
+ * Priority: CLI args override env vars.
+ * Only SWAGGER_MCP_SPEC_URL is required — everything else is optional.
+ */
+export function loadConfig() {
+    const args = parseCliArgs(process.argv.slice(2));
+    const specUrl = args["spec-url"] || process.env.SWAGGER_MCP_SPEC_URL;
+    if (!specUrl) {
+        console.error("Error: Swagger spec URL is required.\n" +
+            "Provide it via --spec-url <url> or SWAGGER_MCP_SPEC_URL env var.");
+        process.exit(1);
+    }
+    // Parse extra headers from JSON string
+    let defaultHeaders = {};
+    const headersRaw = args["headers"] || process.env.SWAGGER_MCP_HEADERS;
+    if (headersRaw) {
+        try {
+            defaultHeaders = JSON.parse(headersRaw);
+        }
+        catch {
+            console.error("Warning: SWAGGER_MCP_HEADERS is not valid JSON, ignoring.");
+        }
+    }
+    const timeoutRaw = args["timeout"] || process.env.SWAGGER_MCP_TIMEOUT;
+    return {
+        specUrl,
+        baseUrl: args["base-url"] || process.env.SWAGGER_MCP_BASE_URL || undefined,
+        auth: {
+            bearerToken: args["bearer-token"] ||
+                process.env.SWAGGER_MCP_BEARER_TOKEN ||
+                undefined,
+            apiKey: args["api-key"] || process.env.SWAGGER_MCP_API_KEY || undefined,
+            apiKeyHeader: args["api-key-header"] ||
+                process.env.SWAGGER_MCP_API_KEY_HEADER ||
+                undefined,
+            basicUser: args["basic-user"] ||
+                process.env.SWAGGER_MCP_BASIC_USER ||
+                undefined,
+            basicPass: args["basic-pass"] ||
+                process.env.SWAGGER_MCP_BASIC_PASS ||
+                undefined,
+        },
+        timeout: timeoutRaw ? parseInt(timeoutRaw, 10) : 30_000,
+        defaultHeaders,
+    };
+}
+/**
+ * Builds a ServerConfig from explicit values (useful for testing and programmatic use).
+ * Applies defaults for optional fields.
+ */
+export function buildConfig(overrides) {
+    return {
+        specUrl: overrides.specUrl,
+        baseUrl: overrides.baseUrl,
+        auth: overrides.auth ?? {},
+        timeout: overrides.timeout ?? 30_000,
+        defaultHeaders: overrides.defaultHeaders ?? {},
+    };
+}
+/**
+ * Simple CLI argument parser.
+ * Supports: --key value and --key=value
+ * Returns a Record<string, string>.
+ */
+export function parseCliArgs(argv) {
+    const result = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (!arg.startsWith("--"))
+            continue;
+        const equalIndex = arg.indexOf("=");
+        if (equalIndex !== -1) {
+            // --key=value
+            const key = arg.substring(2, equalIndex);
+            result[key] = arg.substring(equalIndex + 1);
+        }
+        else {
+            // --key value
+            const key = arg.substring(2);
+            const nextArg = argv[i + 1];
+            if (nextArg && !nextArg.startsWith("--")) {
+                result[key] = nextArg;
+                i++; // skip the value
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,58 @@
+export declare const HTTP_METHODS: readonly ["get", "post", "put", "delete", "patch"];
+export type HttpMethod = (typeof HTTP_METHODS)[number];
+export interface ParsedParameter {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    description?: string;
+    required: boolean;
+    schema: Record<string, unknown>;
+}
+export interface ParsedRequestBody {
+    description?: string;
+    required: boolean;
+    schema: Record<string, unknown>;
+    contentType: string;
+}
+export interface ParsedOperation {
+    /** The operationId from the spec (may be undefined) */
+    operationId?: string;
+    /** HTTP method */
+    method: HttpMethod;
+    /** The raw path template, e.g. /users/{id} */
+    path: string;
+    /** First tag from the operation (if any) */
+    tag?: string;
+    /** Short summary from the spec */
+    summary?: string;
+    /** Longer description from the spec */
+    description?: string;
+    /** All parameters (path, query, header, cookie) */
+    parameters: ParsedParameter[];
+    /** Request body (for POST/PUT/PATCH) */
+    requestBody?: ParsedRequestBody;
+}
+export interface AuthConfig {
+    bearerToken?: string;
+    apiKey?: string;
+    apiKeyHeader?: string;
+    basicUser?: string;
+    basicPass?: string;
+}
+export interface ServerConfig {
+    /** Swagger/OpenAPI spec URL (required) */
+    specUrl: string;
+    /** Override base URL — auto-derived if omitted */
+    baseUrl?: string;
+    /** Authentication configuration */
+    auth: AuthConfig;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout: number;
+    /** Extra headers to attach to every outgoing request */
+    defaultHeaders: Record<string, string>;
+}
+export interface ToolMapping {
+    /** The MCP tool name */
+    toolName: string;
+    /** The parsed operation this tool maps to */
+    operation: ParsedOperation;
+}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+// ─── HTTP Methods we care about ─────────────────────────────────────────────
+export const HTTP_METHODS = ["get", "post", "put", "delete", "patch"];
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AACA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC"}

package/dist/http/auth.d.ts

@@ -0,0 +1,8 @@
+import { AuthConfig } from "../core/types.js";
+/**
+ * Builds authentication headers from the provided auth configuration.
+ * Multiple auth mechanisms can coexist — all matching headers are merged.
+ *
+ * Returns an empty object if no auth is configured.
+ */
+export declare function getAuthHeaders(auth: AuthConfig): Record<string, string>;

package/dist/http/auth.js

@@ -0,0 +1,31 @@
+/**
+ * Builds authentication headers from the provided auth configuration.
+ * Multiple auth mechanisms can coexist — all matching headers are merged.
+ *
+ * Returns an empty object if no auth is configured.
+ */
+export function getAuthHeaders(auth) {
+    const headers = {};
+    // Bearer token → Authorization: Bearer <token>
+    if (auth.bearerToken) {
+        headers["Authorization"] = `Bearer ${auth.bearerToken}`;
+    }
+    // API Key → <header>: <key> (default header: X-API-Key)
+    if (auth.apiKey) {
+        const headerName = auth.apiKeyHeader || "X-API-Key";
+        headers[headerName] = auth.apiKey;
+    }
+    // Basic auth → Authorization: Basic <base64(user:pass)>
+    // Uses !== undefined to allow empty string passwords (which are valid in HTTP Basic Auth).
+    // Note: if bearer is also set, basic will overwrite the Authorization header.
+    if (auth.basicUser !== undefined && auth.basicPass !== undefined) {
+        if (auth.bearerToken) {
+            console.error("[swagger-mcp] Warning: Both Bearer token and Basic auth are configured. " +
+                "Basic auth will overwrite the Authorization header.");
+        }
+        const credentials = Buffer.from(`${auth.basicUser}:${auth.basicPass}`).toString("base64");
+        headers["Authorization"] = `Basic ${credentials}`;
+    }
+    return headers;
+}
+//# sourceMappingURL=auth.js.map

package/dist/http/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/http/auth.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,+CAA+C;IAC/C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IAED,wDAAwD;IACxD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,IAAI,WAAW,CAAC;QACpD,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,wDAAwD;IACxD,2FAA2F;IAC3F,8EAA8E;IAC9E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CACX,0EAA0E;gBACxE,qDAAqD,CACxD,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAC7B,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,CACtC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,WAAW,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/http/request-handler.d.ts

@@ -0,0 +1,12 @@
+import { ServerConfig, ToolMapping } from "../core/types.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 declare function executeToolRequest(mapping: ToolMapping, args: Record<string, unknown>, config: ServerConfig, baseUrl: string): Promise<{
+    content: string;
+    isError: boolean;
+}>;