swagger-doc-explorer-mcp 0.0.1

package/dist/services/swagger-service.js

@@ -0,0 +1,339 @@
+import axios, { AxiosError } from "axios";
+import { readFile } from "fs/promises";
+import { resolve } from "path";
+import { HTTP_METHODS } from "../constants.js";
+const specStore = new Map();
+const METHOD_PRIORITY = {
+    get: 0,
+    post: 1,
+    put: 2,
+    patch: 3,
+    delete: 4,
+    options: 5,
+    head: 6,
+};
+function generateSpecName(title, version) {
+    const base = `${title} v${version}`;
+    let name = base;
+    let counter = 2;
+    while (specStore.has(name)) {
+        name = `${base} (${counter++})`;
+    }
+    return name;
+}
+export function isLoaded(name) {
+    return specStore.has(name);
+}
+export function getLoadedUrls() {
+    return Array.from(specStore.keys());
+}
+export function getSpecKeys() {
+    return Array.from(specStore.keys());
+}
+export function getSpec(name) {
+    return specStore.get(name);
+}
+export function removeSpec(name) {
+    return specStore.delete(name);
+}
+export async function loadSpecFromFile(filePath) {
+    const resolvedPath = resolve(filePath);
+    try {
+        const raw = await readFile(resolvedPath, "utf-8");
+        let data;
+        try {
+            data = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`Failed to parse "${resolvedPath}" as JSON. Ensure the file contains a valid JSON-formatted OpenAPI/Swagger spec.`);
+        }
+        if (!data.openapi && !data.swagger) {
+            throw new Error(`"${resolvedPath}" does not appear to be a valid OpenAPI/Swagger spec. The JSON must contain an 'openapi' or 'swagger' field.`);
+        }
+        const spec = data;
+        if (!spec.info) {
+            throw new Error("Invalid OpenAPI spec: missing 'info' field with title and version.");
+        }
+        spec.info.title = spec.info.title || "Untitled API";
+        spec.info.version = spec.info.version || "0.0.0";
+        spec.paths = spec.paths || {};
+        const name = generateSpecName(spec.info.title, spec.info.version);
+        const store = {
+            spec,
+            name,
+            source: resolvedPath,
+            loadedAt: new Date().toISOString(),
+        };
+        specStore.set(name, store);
+        return store;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith("ENOENT")) {
+            throw new Error(`File not found: "${resolvedPath}". Check that the path is correct.`);
+        }
+        throw error;
+    }
+}
+export async function loadSpec(url, authHeader) {
+    try {
+        const headers = {
+            Accept: "application/json, application/yaml, text/yaml, text/plain",
+        };
+        if (authHeader) {
+            headers["Authorization"] = authHeader;
+        }
+        const response = await axios.get(url, {
+            headers,
+            timeout: 30000,
+            responseType: "text",
+        });
+        let data;
+        const contentType = String(response.headers["content-type"] || "");
+        const raw = response.data;
+        if (contentType.includes("yaml") || contentType.includes("x-yaml") || typeof raw === "string" && (raw.trim().startsWith("openapi:") || raw.trim().startsWith("swagger:"))) {
+            throw new Error("YAML content detected but not supported. Please provide a JSON-formatted OpenAPI spec.");
+        }
+        if (typeof raw === "string") {
+            try {
+                data = JSON.parse(raw);
+            }
+            catch {
+                data = raw;
+            }
+        }
+        else {
+            data = raw;
+        }
+        if (!data.openapi && !data.swagger) {
+            throw new Error("The document does not appear to be a valid OpenAPI/Swagger spec. Ensure the URL returns a JSON document with 'openapi' or 'swagger' field.");
+        }
+        const spec = data;
+        if (!spec.info) {
+            throw new Error("Invalid OpenAPI spec: missing 'info' field with title and version.");
+        }
+        spec.info.title = spec.info.title || "Untitled API";
+        spec.info.version = spec.info.version || "0.0.0";
+        spec.paths = spec.paths || {};
+        const name = generateSpecName(spec.info.title, spec.info.version);
+        const store = {
+            spec,
+            name,
+            source: url,
+            loadedAt: new Date().toISOString(),
+        };
+        specStore.set(name, store);
+        return store;
+    }
+    catch (error) {
+        if (error instanceof AxiosError) {
+            if (error.code === "ECONNREFUSED") {
+                throw new Error(`Failed to connect to ${url}. Ensure the URL is correct and the server is accessible.`);
+            }
+            if (error.code === "ENOTFOUND") {
+                throw new Error(`DNS lookup failed for ${url}. Check the URL is spelled correctly.`);
+            }
+            if (error.response) {
+                const status = error.response.status;
+                if (status === 404) {
+                    throw new Error(`Spec not found at ${url} (404). Verify the URL points to an existing OpenAPI JSON document.`);
+                }
+                if (status === 403) {
+                    throw new Error(`Access denied to ${url} (403). You may need to provide an auth header.`);
+                }
+                throw new Error(`Failed to fetch spec from ${url}: HTTP ${status}`);
+            }
+            if (error.code === "ECONNABORTED") {
+                throw new Error(`Request to ${url} timed out. The server may be slow or unreachable.`);
+            }
+        }
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error(`Unexpected error loading spec from ${url}`);
+    }
+}
+export function getEndpoints(name, tag) {
+    const store = specStore.get(name);
+    if (!store)
+        return [];
+    const endpoints = [];
+    for (const [path, pathItem] of Object.entries(store.spec.paths)) {
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            if (tag && (!operation.tags || !operation.tags.includes(tag)))
+                continue;
+            endpoints.push({
+                path,
+                method: method,
+                summary: operation.summary || operation.operationId || `${method.toUpperCase()} ${path}`,
+                operationId: operation.operationId,
+                tags: operation.tags || [],
+                deprecated: operation.deprecated || false,
+            });
+        }
+    }
+    endpoints.sort((a, b) => {
+        if (a.path !== b.path)
+            return a.path.localeCompare(b.path);
+        return (METHOD_PRIORITY[a.method] ?? 99) - (METHOD_PRIORITY[b.method] ?? 99);
+    });
+    return endpoints;
+}
+export function getEndpointDetail(name, path, method) {
+    const store = specStore.get(name);
+    if (!store)
+        return null;
+    const pathItem = store.spec.paths[path];
+    if (!pathItem)
+        return null;
+    const operation = pathItem[method];
+    return operation || null;
+}
+export function getPathParameterNames(path) {
+    const matches = path.match(/\{(\w+)\}/g);
+    if (!matches)
+        return [];
+    return matches.map((m) => m.slice(1, -1));
+}
+export function getSchemas(name) {
+    const store = specStore.get(name);
+    if (!store)
+        return [];
+    const schemas = store.spec.components?.schemas || store.spec.definitions || {};
+    const result = [];
+    for (const [name, schema] of Object.entries(schemas)) {
+        const props = schema.properties ? Object.keys(schema.properties).length : 0;
+        result.push({
+            name,
+            type: schema.type || "object",
+            description: schema.description || schema.title,
+            properties: props,
+        });
+    }
+    result.sort((a, b) => a.name.localeCompare(b.name));
+    return result;
+}
+export function getSchemaDetail(name, schemaName) {
+    const store = specStore.get(name);
+    if (!store)
+        return null;
+    const schemas = store.spec.components?.schemas || store.spec.definitions || {};
+    return schemas[schemaName] || null;
+}
+export function getTags(name) {
+    const store = specStore.get(name);
+    if (!store)
+        return [];
+    const tagCounts = new Map();
+    for (const pathItem of Object.values(store.spec.paths)) {
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation?.tags)
+                continue;
+            for (const tag of operation.tags) {
+                tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
+            }
+        }
+    }
+    return Array.from(tagCounts.entries())
+        .map(([name, count]) => ({ name, count }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+export function searchSpec(name, query) {
+    const store = specStore.get(name);
+    if (!store)
+        return [];
+    const results = [];
+    const lowerQuery = query.toLowerCase();
+    const schemas = store.spec.components?.schemas || store.spec.definitions || {};
+    for (const [path, pathItem] of Object.entries(store.spec.paths)) {
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const searchText = [
+                path,
+                method,
+                operation.summary,
+                operation.operationId,
+                operation.description,
+                ...(operation.tags || []),
+            ]
+                .filter(Boolean)
+                .join(" ")
+                .toLowerCase();
+            if (searchText.includes(lowerQuery)) {
+                results.push({
+                    type: "endpoint",
+                    path,
+                    method: method,
+                    match: `${method.toUpperCase()} ${path}`,
+                    summary: operation.summary || operation.operationId,
+                });
+            }
+        }
+    }
+    for (const [name, schema] of Object.entries(schemas)) {
+        const schemaSearchText = [name, schema.description, schema.title].filter(Boolean).join(" ").toLowerCase();
+        if (schemaSearchText.includes(lowerQuery)) {
+            results.push({
+                type: "schema",
+                schemaName: name,
+                match: `Schema: ${name}`,
+                summary: schema.description,
+            });
+        }
+        if (schema.properties) {
+            for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                const propSearchText = [propName, propSchema.description].filter(Boolean).join(" ").toLowerCase();
+                if (propSearchText.includes(lowerQuery)) {
+                    results.push({
+                        type: "property",
+                        schemaName: name,
+                        propertyName: propName,
+                        match: `Schema ${name} > ${propName}`,
+                        summary: propSchema.description,
+                    });
+                }
+            }
+        }
+    }
+    return results;
+}
+export function resolveRef(ref, name) {
+    const store = specStore.get(name);
+    if (!store)
+        return null;
+    const parts = ref.replace(/^#\//, "").split("/");
+    let current = store.spec;
+    for (const part of parts) {
+        if (current && typeof current === "object" && part in current) {
+            current = current[part];
+        }
+        else {
+            return null;
+        }
+    }
+    return current;
+}
+export function getServerUrl(name) {
+    const store = specStore.get(name);
+    if (!store)
+        return "";
+    const spec = store.spec;
+    if (spec.servers && spec.servers.length > 0) {
+        let baseUrl = spec.servers[0].url;
+        if (baseUrl.endsWith("/"))
+            baseUrl = baseUrl.slice(0, -1);
+        return baseUrl;
+    }
+    if (spec.host) {
+        const scheme = spec.schemes?.[0] || "https";
+        const basePath = spec.basePath || "";
+        return `${scheme}://${spec.host}${basePath}`;
+    }
+    return "";
+}
+//# sourceMappingURL=swagger-service.js.map

package/dist/services/swagger-service.js.map

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

package/dist/tools/info.d.ts

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

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

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

package/dist/tools/info.js

@@ -0,0 +1,161 @@
+import { z } from "zod";
+import { isLoaded, getSpec, getEndpoints, getSchemas, getTags, getServerUrl } from "../services/swagger-service.js";
+export function registerInfoTools(server) {
+    server.registerTool("swagger_get_info", {
+        title: "Get API Info",
+        description: `Get general information about a loaded OpenAPI/Swagger specification, including title, version, description, server URL, contact info, and license.
+
+Use this tool to get a high-level summary of an API spec.
+
+Args:
+  - spec_name (string): Name of the previously loaded spec (use swagger_list_loaded to see available names)
+
+Returns:
+  {
+    "title": string,           // API title
+    "version": string,         // API version
+    "description": string,     // API description
+    "server_url": string,      // Base server URL
+    "endpoints": number,       // Total endpoint count
+    "schemas": number,         // Total schema count
+    "tags": number,            // Total tag count
+    "openapi_version": string  // OpenAPI spec version
+  }
+
+Examples:
+  - Use when: "Tell me about this API" -> params with spec_name="<name>"
+  - Use when: "What's the base URL for this API?" -> params with spec_name="<name>"
+
+Error Handling:
+  - Returns error if the spec name has not been loaded`,
+        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)"),
+        }).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 store = getSpec(params.spec_name);
+            if (!store)
+                return { content: [{ type: "text", text: "Error: Spec data not found in memory." }] };
+            const spec = store.spec;
+            const endpoints = getEndpoints(params.spec_name);
+            const schemas = getSchemas(params.spec_name);
+            const tags = getTags(params.spec_name);
+            const serverUrl = getServerUrl(params.spec_name);
+            const specVersion = spec.openapi || spec.swagger || "unknown";
+            const output = {
+                title: spec.info.title, version: spec.info.version,
+                description: spec.info.description || "", server_url: serverUrl,
+                endpoints: endpoints.length, schemas: schemas.length, tags: tags.length,
+                openapi_version: specVersion,
+                contact: spec.info.contact || null,
+                license: spec.info.license || null,
+            };
+            const lines = [
+                `# ${spec.info.title}`,
+                "",
+                `**Version**: ${spec.info.version}`,
+                `**OpenAPI Version**: ${specVersion}`,
+                `**Server**: \`${serverUrl || "Not specified"}\``,
+                "",
+                spec.info.description || "",
+                "",
+                "## Summary",
+                `- **Endpoints**: ${endpoints.length}`,
+                `- **Schemas**: ${schemas.length}`,
+                `- **Tags**: ${tags.length}`,
+            ];
+            const contact = spec.info.contact;
+            if (contact) {
+                lines.push("", "## Contact");
+                if (contact.name)
+                    lines.push(`- **Name**: ${contact.name}`);
+                if (contact.email)
+                    lines.push(`- **Email**: ${contact.email}`);
+                if (contact.url)
+                    lines.push(`- **URL**: ${contact.url}`);
+            }
+            const license = spec.info.license;
+            if (license) {
+                lines.push("", "## License");
+                lines.push(`- **Name**: ${license.name}`);
+                if (license.url)
+                    lines.push(`- **URL**: ${license.url}`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }] };
+        }
+    });
+    server.registerTool("swagger_list_tags", {
+        title: "List API Tags",
+        description: `List all API tags/groups and their associated endpoint counts from a loaded OpenAPI spec.
+
+Tags are used to group related endpoints. This tool helps with progressive exploration by showing available filter categories.
+
+Args:
+  - spec_name (string): Name of the previously loaded spec
+
+Returns:
+  {
+    "tags": [{ "name": string, "count": number }]
+  }
+
+Examples:
+  - Use when: "What tags/groups are available?" -> params with spec_name="<name>"
+  - Use when: "How are the endpoints organized?" -> params with spec_name="<name>"
+
+Error Handling:
+  - Returns error if the spec name has not been loaded`,
+        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)"),
+        }).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 tags = getTags(params.spec_name);
+            const store = getSpec(params.spec_name);
+            if (tags.length === 0) {
+                return { content: [{ type: "text", text: "No tags found in this spec. Endpoints may be untagged." }] };
+            }
+            const lines = [
+                `# ${store?.spec.info.title || "API"} - Tags`,
+                "",
+                "| Tag | Endpoints |",
+                "|-----|-----------|",
+            ];
+            for (const tag of tags) {
+                lines.push(`| \`${tag.name}\` | ${tag.count} |`);
+            }
+            lines.push("", "Use `swagger_list_paths` with a `tag` parameter to filter by group.");
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+                structuredContent: { tags },
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }] };
+        }
+    });
+}
+//# sourceMappingURL=info.js.map

package/dist/tools/info.js.map

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

package/dist/tools/load-spec.d.ts

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

package/dist/tools/load-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-spec.d.ts","sourceRoot":"","sources":["../../src/tools/load-spec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,QAyStD"}