swagger-doc-explorer-mcp 0.0.1

package/dist/tools/load-spec.js

@@ -0,0 +1,278 @@
+import { z } from "zod";
+import { loadSpec, loadSpecFromFile, isLoaded, getSpecKeys, getSpec, getEndpoints, getSchemas, getTags, getServerUrl, removeSpec } from "../services/swagger-service.js";
+export function registerLoadSpecTools(server) {
+    server.registerTool("swagger_load_spec", {
+        title: "Load Swagger/OpenAPI Spec",
+        description: `Load and parse an OpenAPI (Swagger) specification document from a URL.
+
+This tool fetches a JSON OpenAPI/Swagger spec from the given URL and stores it in memory for subsequent exploration. You must load a spec before using any other tools.
+
+Each loaded spec is assigned a unique name (title + version). If a spec with the same name already exists, a numeric suffix is appended.
+
+Args:
+  - url (string): URL to the OpenAPI/Swagger JSON spec (e.g., "https://petstore.swagger.io/v2/swagger.json")
+  - auth_header (string, optional): Authorization header value for protected specs (e.g., "Bearer token123" or "Basic base64encoded"). Only needed for authenticated endpoints.
+
+Returns:
+  {
+    "spec_name": string,      // The assigned spec name for subsequent tools
+    "title": string,          // API title from the spec
+    "version": string,        // API version from the spec
+    "description": string,    // API description (if available)
+    "endpoints": number,      // Total number of API endpoints found
+    "schemas": number,        // Total number of schemas/components found
+    "tags": number,           // Total number of unique tags found
+    "server_url": string      // Base server URL from the spec
+  }
+
+Examples:
+  - Use when: "Load the Petstore API spec" -> params with url="https://petstore.swagger.io/v2/swagger.json"
+  - Use when: "Load our internal API docs" -> params with url="https://api.internal.company.com/openapi.json"
+
+Error Handling:
+  - Returns error if URL is unreachable or times out
+  - Returns error if the document is not valid OpenAPI/Swagger JSON
+  - Returns error if YAML format is provided (only JSON is supported)`,
+        inputSchema: z.object({
+            url: z.string().url().describe("URL to the OpenAPI/Swagger JSON spec (e.g., 'https://petstore.swagger.io/v2/swagger.json')"),
+            auth_header: z.string().optional().describe("Authorization header value for protected specs (e.g., 'Bearer eyJhbGci...' or 'Basic base64string'). Only needed if the spec requires authentication."),
+        }).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const store = await loadSpec(params.url, params.auth_header);
+            const endpoints = getEndpoints(store.name);
+            const schemas = getSchemas(store.name);
+            const tags = getTags(store.name);
+            const serverUrl = getServerUrl(store.name);
+            const output = {
+                spec_name: store.name,
+                title: store.spec.info.title,
+                version: store.spec.info.version,
+                description: store.spec.info.description || "",
+                endpoints: endpoints.length,
+                schemas: schemas.length,
+                tags: tags.length,
+                server_url: serverUrl,
+            };
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `# ${output.title} v${output.version}`,
+                            "",
+                            output.description,
+                            "",
+                            "## Summary",
+                            `- **Spec Name**: \`${output.spec_name}\``,
+                            `- **Endpoints**: ${output.endpoints} paths`,
+                            `- **Schemas**: ${output.schemas} component schemas`,
+                            `- **Tags**: ${output.tags} groups`,
+                            `- **Server**: \`${output.server_url || "Not specified"}\``,
+                        ].join("\n"),
+                    }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+            };
+        }
+    });
+    server.registerTool("swagger_load_local_spec", {
+        title: "Load Local Swagger/OpenAPI Spec File",
+        description: `Load and parse an OpenAPI (Swagger) specification document from a local JSON file.
+
+This tool reads a JSON OpenAPI/Swagger spec from a local file path and stores it in memory for subsequent exploration. The file path can be absolute or relative to the current working directory.
+
+Each loaded spec is assigned a unique name (title + version). If a spec with the same name already exists, a numeric suffix is appended.
+
+Args:
+  - file_path (string): Path to a local OpenAPI/Swagger JSON file (e.g., "./swagger.doc.json" or "/path/to/api-spec.json")
+
+Returns:
+  {
+    "spec_name": string,      // The assigned spec name for subsequent tools
+    "title": string,          // API title from the spec
+    "version": string,        // API version from the spec
+    "description": string,    // API description (if available)
+    "endpoints": number,      // Total number of API endpoints found
+    "schemas": number,        // Total number of schemas/components found
+    "tags": number,           // Total number of unique tags found
+    "server_url": string      // Base server URL from the spec
+  }
+
+Examples:
+  - Use when: "Load the local swagger.doc.json" -> params with file_path="./swagger.doc.json"
+  - Use when: "Load our API spec from disk" -> params with file_path="/home/user/projects/api/openapi.json"
+
+Error Handling:
+  - Returns error if the file path does not exist
+  - Returns error if the file is not valid JSON
+  - Returns error if the JSON is not a valid OpenAPI/Swagger spec`,
+        inputSchema: z.object({
+            file_path: z.string().min(1).describe("Path to a local OpenAPI/Swagger JSON file (e.g., './swagger.doc.json' or '/absolute/path/to/spec.json')"),
+        }).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const store = await loadSpecFromFile(params.file_path);
+            const endpoints = getEndpoints(store.name);
+            const schemas = getSchemas(store.name);
+            const tags = getTags(store.name);
+            const serverUrl = getServerUrl(store.name);
+            const output = {
+                spec_name: store.name,
+                title: store.spec.info.title,
+                version: store.spec.info.version,
+                description: store.spec.info.description || "",
+                endpoints: endpoints.length,
+                schemas: schemas.length,
+                tags: tags.length,
+                server_url: serverUrl,
+            };
+            return {
+                content: [{
+                        type: "text",
+                        text: [
+                            `# ${output.title} v${output.version}`,
+                            "",
+                            output.description,
+                            "",
+                            "## Summary",
+                            `- **Spec Name**: \`${output.spec_name}\``,
+                            `- **Source**: \`${store.source}\``,
+                            `- **Endpoints**: ${output.endpoints} paths`,
+                            `- **Schemas**: ${output.schemas} component schemas`,
+                            `- **Tags**: ${output.tags} groups`,
+                            `- **Server**: \`${output.server_url || "Not specified"}\``,
+                        ].join("\n"),
+                    }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+            };
+        }
+    });
+    server.registerTool("swagger_list_loaded", {
+        title: "List Loaded Specs",
+        description: `List all currently loaded OpenAPI/Swagger specifications in memory.
+
+Use this tool to see which specs have been loaded and are available for exploration.
+
+Args: None
+
+Returns:
+  {
+    "loaded": [              // Array of loaded specs
+      { "name": string, "title": string, "version": string, "source": string, "loaded_at": string }
+    ]
+  }
+
+Examples:
+  - Use when: "What specs have I loaded?" -> no params needed
+  - Use when: "Show my loaded APIs" -> no params needed`,
+        inputSchema: z.object({}).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        try {
+            const names = getSpecKeys();
+            const specs = names.map((name) => {
+                const store = getSpec(name);
+                return {
+                    name,
+                    title: store?.spec.info.title || "Unknown",
+                    version: store?.spec.info.version || "?",
+                    source: store?.source || "?",
+                    loaded_at: store?.loadedAt || "?",
+                };
+            });
+            if (specs.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No specs loaded. Use `swagger_load_spec` to load an OpenAPI/Swagger spec." }],
+                };
+            }
+            const lines = [
+                "# Loaded Specifications",
+                "",
+                "| # | Name | Title | Version | Source |",
+                "|---|------|-------|---------|--------|",
+            ];
+            for (let i = 0; i < specs.length; i++) {
+                lines.push(`| ${i + 1} | \`${specs[i].name}\` | ${specs[i].title} | ${specs[i].version} | \`${specs[i].source}\` |`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+                structuredContent: { loaded: specs },
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+            };
+        }
+    });
+    server.registerTool("swagger_remove_spec", {
+        title: "Remove Loaded Spec",
+        description: `Remove a loaded OpenAPI/Swagger specification from memory.
+
+Use this tool to free up memory or reload a spec that has changed.
+
+Args:
+  - spec_name (string): Name of the spec to remove
+
+Returns:
+  Confirmation message.
+
+Examples:
+  - Use when: "Remove the Petstore API spec" -> params with spec_name="Petstore v1.0.0"
+  - Use when: "Unload the internal API spec" -> params with spec_name="Internal API v2.0"
+
+Error Handling:
+  - Returns error if the spec name is not found`,
+        inputSchema: z.object({
+            spec_name: z.string().min(1).describe("Name of the spec to remove (use swagger_list_loaded to see available names)"),
+        }).strict(),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            if (!isLoaded(params.spec_name)) {
+                return { content: [{ type: "text", text: `Error: Spec '${params.spec_name}' not found. Use swagger_list_loaded to see available specs.` }] };
+            }
+            removeSpec(params.spec_name);
+            return {
+                content: [{ type: "text", text: `Removed spec: \`${params.spec_name}\`` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
+            };
+        }
+    });
+}
+//# sourceMappingURL=load-spec.js.map

package/dist/tools/load-spec.js.map

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

package/dist/tools/paths.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPathsTools(server: McpServer): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/tools/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,QA2OnD"}

package/dist/tools/paths.js

@@ -0,0 +1,216 @@
+import { z } from "zod";
+import { CHARACTER_LIMIT } from "../constants.js";
+import { isLoaded, getEndpoints, getEndpointDetail, getPathParameterNames, getSpec, getTags } from "../services/swagger-service.js";
+import { formatEndpointDetail } from "../formatters.js";
+export function registerPathsTools(server) {
+    server.registerTool("swagger_list_paths", {
+        title: "List API Endpoints",
+        description: `List all API endpoints (paths and HTTP methods) from a loaded OpenAPI spec, optionally filtered by tag.
+
+Use this tool to get a high-level overview of all available API operations. Results can be filtered by tag for progressive exploration.
+
+Args:
+  - spec_name (string): Name of the previously loaded spec
+  - tag (string, optional): Filter endpoints by this tag/group name
+  - limit (number): Maximum results to return, between 1-200 (default: 50)
+  - offset (number): Number of results to skip for pagination (default: 0)
+
+Returns:
+  {
+    "total": number,                 // Total number of matching endpoints
+    "count": number,                 // Number of results in this response
+    "offset": number,                // Current pagination offset
+    "endpoints": [...],
+    "has_more": boolean,
+    "next_offset": number
+  }
+
+Examples:
+  - Use when: "Show me all endpoints" -> params with spec_name="<name>"
+  - Use when: "List all user-related endpoints" -> params with spec_name="<name>", tag="users"
+
+Error Handling:
+  - Returns error if the spec name has not been loaded yet`,
+        inputSchema: z.object({
+            spec_name: z.string().min(1).describe("Name of the previously loaded OpenAPI/Swagger spec (use swagger_list_loaded to see available names)"),
+            tag: z.string().optional().describe("Filter endpoints by tag/group name (e.g., 'users', 'pets', 'store'). Use swagger_list_tags to see available tags."),
+            limit: z.number().int().min(1).max(200).default(50).describe("Maximum results to return (default: 50, max: 200)"),
+            offset: z.number().int().min(0).default(0).describe("Number of results to skip for pagination (default: 0)"),
+        }).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            if (!isLoaded(params.spec_name)) {
+                return { content: [{ type: "text", text: `Error: Spec '${params.spec_name}' has not been loaded yet. Use swagger_load_spec to load it first.` }] };
+            }
+            const allEndpoints = getEndpoints(params.spec_name, params.tag);
+            const total = allEndpoints.length;
+            const paginated = allEndpoints.slice(params.offset, params.offset + params.limit);
+            if (paginated.length === 0) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: total === 0
+                                ? `No endpoints found${params.tag ? ` for tag '${params.tag}'` : ""} in the spec.`
+                                : `No more endpoints to show (showing ${params.offset} of ${total}).`,
+                        }],
+                };
+            }
+            const hasMore = total > params.offset + paginated.length;
+            const tags = getTags(params.spec_name);
+            const store = getSpec(params.spec_name);
+            const output = {
+                total,
+                count: paginated.length,
+                offset: params.offset,
+                endpoints: paginated,
+                has_more: hasMore,
+                ...(hasMore ? { next_offset: params.offset + paginated.length } : {}),
+            };
+            const lines = [];
+            lines.push(`# ${store?.spec.info.title || "API"} - Endpoints`);
+            if (params.tag) {
+                lines.push(`\nFiltered by tag: \`${params.tag}\``);
+            }
+            lines.push(`\n**${total} total endpoints** (showing ${paginated.length})`);
+            lines.push("");
+            for (const ep of paginated) {
+                const deprecationBadge = ep.deprecated ? " ~~(deprecated)~~" : "";
+                lines.push(`### \`${ep.method.toUpperCase()}\` ${ep.path}${deprecationBadge}`);
+                if (ep.summary)
+                    lines.push(`${ep.summary}`);
+                if (ep.operationId)
+                    lines.push(`- Operation ID: \`${ep.operationId}\``);
+                if (ep.tags.length > 0)
+                    lines.push(`- Tags: ${ep.tags.map((t) => `\`${t}\``).join(", ")}`);
+                lines.push("");
+            }
+            if (hasMore) {
+                lines.push(`> Showing ${paginated.length} of ${total} endpoints. Use offset=${params.offset + paginated.length} to see more.`);
+            }
+            if (tags.length > 0 && !params.tag) {
+                lines.push("---");
+                lines.push("## Available Tags");
+                lines.push("Use the `tag` parameter to filter by group:");
+                lines.push("");
+                for (const tag of tags) {
+                    lines.push(`- \`${tag.name}\` (${tag.count} endpoints)`);
+                }
+            }
+            let textContent = lines.join("\n");
+            if (textContent.length > CHARACTER_LIMIT) {
+                textContent = textContent.slice(0, CHARACTER_LIMIT) + "\n\n... (truncated)";
+            }
+            return {
+                content: [{ type: "text", text: textContent }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }] };
+        }
+    });
+    server.registerTool("swagger_get_endpoint", {
+        title: "Get Endpoint Details",
+        description: `Get detailed information about a specific API endpoint, including parameters, request body, responses, and security requirements.
+
+Use this tool after swagger_list_paths to drill down into a specific endpoint's complete details.
+
+Args:
+  - spec_name (string): Name of the previously loaded spec
+  - path (string): URL path of the endpoint (e.g., "/pets/{petId}")
+  - method (string): HTTP method (get, post, put, patch, delete, options, head)
+
+Returns:
+  Full endpoint details with parameters, request body, responses, and security.
+
+Examples:
+  - Use when: "Show me the details of GET /pets/{petId}" -> params with spec_name="<name>", path="/pets/{petId}", method="get"
+  - Use when: "What parameters does the create user endpoint take?" -> params with spec_name="<name>", path="/users", method="post"
+
+Error Handling:
+  - Returns error if the spec name has not been loaded
+  - Returns error if the path or method is not found, with suggestions`,
+        inputSchema: z.object({
+            spec_name: z.string().min(1).describe("Name of the previously loaded OpenAPI/Swagger spec (use swagger_list_loaded to see available names)"),
+            path: z.string().describe("URL path of the endpoint (e.g., '/pets/{petId}', '/users', '/store/order'). Must start with '/'."),
+            method: z.enum(["get", "post", "put", "patch", "delete", "options", "head"]).describe("HTTP method (get, post, put, patch, delete, options, head)"),
+        }).strict(),
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (params) => {
+        try {
+            if (!isLoaded(params.spec_name)) {
+                return { content: [{ type: "text", text: `Error: Spec '${params.spec_name}' has not been loaded yet. Use swagger_load_spec to load it first.` }] };
+            }
+            const detail = getEndpointDetail(params.spec_name, params.path, params.method);
+            if (!detail) {
+                const allEndpoints = getEndpoints(params.spec_name);
+                const similarPaths = allEndpoints
+                    .filter((ep) => ep.path.includes(params.path) || params.path.includes(ep.path))
+                    .slice(0, 5);
+                let suggestion = "";
+                if (similarPaths.length > 0) {
+                    suggestion = `\n\nDid you mean one of these?\n${similarPaths.map((ep) => `  - ${ep.method.toUpperCase()} ${ep.path}`).join("\n")}`;
+                }
+                return { content: [{ type: "text", text: `Error: No ${params.method.toUpperCase()} operation found for path '${params.path}'.${suggestion}` }] };
+            }
+            const paramNames = getPathParameterNames(params.path);
+            const mergedParameters = [
+                ...paramNames.map((name) => {
+                    const existingParam = (detail.parameters || []).find((p) => p.name === name);
+                    if (existingParam)
+                        return existingParam;
+                    return { name, in: "path", required: true, description: `Path parameter: ${name}`, schema: { type: "string" } };
+                }),
+                ...(detail.parameters || []).filter((p) => !paramNames.includes(p.name)),
+            ];
+            const endpointInfo = {
+                path: params.path,
+                method: params.method,
+                summary: detail.summary,
+                description: detail.description,
+                operationId: detail.operationId,
+                tags: detail.tags || [],
+                deprecated: detail.deprecated || false,
+                parameters: mergedParameters,
+                requestBody: detail.requestBody
+                    ? {
+                        description: detail.requestBody.description,
+                        required: detail.requestBody.required,
+                        content: Object.fromEntries(Object.entries(detail.requestBody.content).map(([ct, mt]) => [ct, { schema: mt.schema }])),
+                    }
+                    : undefined,
+                responses: detail.responses
+                    ? Object.fromEntries(Object.entries(detail.responses).map(([code, resp]) => [
+                        code,
+                        {
+                            description: resp.description,
+                            content: resp.content
+                                ? Object.fromEntries(Object.entries(resp.content).map(([ct, mt]) => [ct, { schema: mt.schema }]))
+                                : undefined,
+                        },
+                    ]))
+                    : undefined,
+                security: detail.security,
+            };
+            return {
+                content: [{ type: "text", text: formatEndpointDetail(endpointInfo) }],
+                structuredContent: endpointInfo,
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=paths.js.map

package/dist/tools/paths.js.map

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

package/dist/tools/schemas.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSchemasTools(server: McpServer): void;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,QAwJrD"}