specrun 1.0.0

package/dist/utils/openapi-parser.js

@@ -0,0 +1,398 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOpenApiSpec = parseOpenApiSpec;
+exports.updateSpecServerUrls = updateSpecServerUrls;
+exports.resolveServerUrl = resolveServerUrl;
+exports.isOpenAPIFile = isOpenAPIFile;
+const swagger_parser_1 = __importDefault(require("@apidevtools/swagger-parser"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const yaml_1 = __importDefault(require("yaml"));
+const auth_1 = require("./auth");
+const DEFAULT_SERVER_URL = "https://api-server.placeholder";
+async function parseOpenApiSpec(filePath) {
+    try {
+        const spec = (await swagger_parser_1.default.validate(filePath)); // OpenAPIV3.Document;
+        const apiName = (0, auth_1.getApiNameFromFile)(filePath);
+        const tools = generateToolsFromSpec(spec, apiName);
+        return {
+            apiName,
+            filePath,
+            spec,
+            tools,
+        };
+    }
+    catch (error) {
+        // Only log errors for files that look like they should be OpenAPI specs
+        const filename = path_1.default.basename(filePath);
+        if (filename.toLowerCase().includes("openapi") ||
+            filename.toLowerCase().includes("swagger") ||
+            filename.toLowerCase().includes("api")) {
+            console.error(`Failed to parse OpenAPI spec at ${filePath}:`, error);
+        }
+        else {
+            // For other files, just log a brief message
+            console.log(`Skipping ${filename} - not a valid OpenAPI specification`);
+        }
+        return null;
+    }
+}
+function generateToolsFromSpec(spec, apiName) {
+    const tools = [];
+    const baseUrl = getBaseUrl(spec);
+    if (!spec.paths)
+        return tools;
+    for (const [pathTemplate, pathItem] of Object.entries(spec.paths)) {
+        if (!pathItem || typeof pathItem !== "object")
+            continue;
+        const methods = [
+            "get",
+            "post",
+            "put",
+            "patch",
+            "delete",
+            "head",
+            "options",
+        ];
+        for (const method of methods) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const tool = createToolFromOperation(apiName, pathTemplate, method, operation, baseUrl, pathItem.parameters, spec);
+            if (tool) {
+                tools.push(tool);
+            }
+        }
+    }
+    return tools;
+}
+function createToolFromOperation(apiName, pathTemplate, method, operation, baseUrl, pathLevelParams, spec) {
+    try {
+        const toolName = generateToolName(apiName, operation, pathTemplate, method);
+        const description = operation.summary ||
+            operation.description ||
+            `${method.toUpperCase()} ${pathTemplate}`;
+        // Combine path-level and operation-level parameters
+        const allParams = [
+            ...(pathLevelParams || []),
+            ...(operation.parameters || []),
+        ];
+        const parameters = extractParameters(allParams, spec);
+        return {
+            name: toolName,
+            description,
+            operationId: operation.operationId,
+            method: method.toUpperCase(),
+            path: pathTemplate,
+            parameters,
+            requestBody: operation.requestBody,
+            responses: operation.responses,
+            security: operation.security || [],
+            baseUrl,
+        };
+    }
+    catch (error) {
+        console.error(`Failed to create tool for ${method} ${pathTemplate}:`, error);
+        return null;
+    }
+}
+function generateToolName(apiName, operation, pathTemplate, method) {
+    if (operation.operationId) {
+        return `${apiName}_${operation.operationId}`;
+    }
+    // Generate from path and method
+    const pathParts = pathTemplate
+        .split("/")
+        .filter((part) => part && !part.startsWith("{"))
+        .map((part) => part.replace(/[^a-zA-Z0-9]/g, ""));
+    const pathName = pathParts.join("_") || "root";
+    return `${apiName}_${method}_${pathName}`;
+}
+function extractParameters(paramRefs, spec) {
+    const parameters = [];
+    for (const paramRef of paramRefs) {
+        const param = resolveParameterRef(paramRef, spec);
+        if (!param) {
+            continue;
+        }
+        const schema = getParameterSchema(param);
+        if (param.in && param.name && schema) {
+            parameters.push({
+                name: param.name,
+                in: param.in,
+                required: param.required || param.in === "path",
+                schema: schema,
+                description: param.description,
+            });
+        }
+    }
+    return parameters;
+}
+function getBaseUrl(spec) {
+    if (isOpenApi3Spec(spec) && typeof spec["x-base-url"] === "string") {
+        const baseUrl = spec["x-base-url"].trim();
+        if (baseUrl) {
+            return appendBasePathIfNeeded(baseUrl, spec);
+        }
+    }
+    if (isOpenApi3Spec(spec) && spec.servers && spec.servers.length > 0) {
+        const baseUrl = resolveOpenApi3ServerUrl(spec.servers[0]);
+        return appendBasePathIfNeeded(baseUrl, spec);
+    }
+    if (isSwagger2Spec(spec)) {
+        const schemes = Array.isArray(spec.schemes) ? spec.schemes : [];
+        const scheme = schemes[0] || "https";
+        const host = typeof spec.host === "string" ? spec.host : "";
+        const basePath = typeof spec.basePath === "string" ? spec.basePath : "";
+        if (host) {
+            return `${scheme}://${host}${basePath}`;
+        }
+    }
+    // Fallback for older specs or specs without servers
+    return DEFAULT_SERVER_URL;
+}
+function resolveParameterRef(paramRef, spec) {
+    if (!paramRef || typeof paramRef !== "object") {
+        return null;
+    }
+    if (!("$ref" in paramRef)) {
+        return paramRef;
+    }
+    const ref = String(paramRef.$ref || "");
+    if (!ref || !spec) {
+        return null;
+    }
+    return resolveJsonPointer(spec, ref);
+}
+function resolveJsonPointer(root, ref) {
+    if (!ref.startsWith("#/")) {
+        return null;
+    }
+    const parts = ref
+        .slice(2)
+        .split("/")
+        .map((part) => part.replace(/~1/g, "/").replace(/~0/g, "~"));
+    let current = root;
+    for (const part of parts) {
+        if (!current || typeof current !== "object" || !(part in current)) {
+            return null;
+        }
+        current = current[part];
+    }
+    return current;
+}
+function getParameterSchema(param) {
+    if (param.schema && typeof param.schema === "object") {
+        return param.schema;
+    }
+    if (param.content && typeof param.content === "object") {
+        const content = param.content;
+        const preferred = content["application/json"] ||
+            Object.values(content).find((entry) => entry && entry.schema);
+        if (preferred && preferred.schema) {
+            return preferred.schema;
+        }
+    }
+    if (param.type) {
+        const schema = { type: param.type };
+        if (param.format) {
+            schema.format = param.format;
+        }
+        if (param.items) {
+            schema.items = param.items;
+        }
+        if (param.enum) {
+            schema.enum = param.enum;
+        }
+        if (param.default !== undefined) {
+            schema.default = param.default;
+        }
+        return schema;
+    }
+    return null;
+}
+function resolveOpenApi3ServerUrl(server) {
+    if (!server || typeof server !== "object") {
+        return DEFAULT_SERVER_URL;
+    }
+    const rawUrl = typeof server.url === "string" ? server.url : "";
+    if (!rawUrl) {
+        return DEFAULT_SERVER_URL;
+    }
+    if (!server.variables || typeof server.variables !== "object") {
+        return rawUrl;
+    }
+    return rawUrl.replace(/\{([^}]+)\}/g, (_match, varName) => {
+        const variable = server.variables[varName];
+        if (variable && typeof variable.default === "string") {
+            return variable.default;
+        }
+        return _match;
+    });
+}
+function appendBasePathIfNeeded(baseUrl, spec) {
+    const basePath = getOpenApiBasePath(spec);
+    if (!basePath) {
+        return baseUrl;
+    }
+    try {
+        const parsed = new URL(baseUrl);
+        const hasPath = parsed.pathname && parsed.pathname !== "/";
+        if (hasPath) {
+            return baseUrl;
+        }
+        parsed.pathname = basePath;
+        return parsed.toString().replace(/\/$/, "");
+    }
+    catch {
+        return baseUrl;
+    }
+}
+function getOpenApiBasePath(spec) {
+    const raw = (typeof spec?.basePath === "string" && spec.basePath) || "";
+    const trimmed = String(raw).trim();
+    if (!trimmed) {
+        return null;
+    }
+    return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+function readSpecFile(filePath) {
+    try {
+        const content = fs_1.default.readFileSync(filePath, "utf8");
+        const ext = path_1.default.extname(filePath).toLowerCase();
+        if (ext === ".json") {
+            return { spec: JSON.parse(content), format: "json" };
+        }
+        return { spec: yaml_1.default.parse(content), format: "yaml" };
+    }
+    catch {
+        return null;
+    }
+}
+function writeSpecFile(filePath, spec, format) {
+    if (format === "json") {
+        fs_1.default.writeFileSync(filePath, `${JSON.stringify(spec, null, 2)}\n`, "utf8");
+        return;
+    }
+    fs_1.default.writeFileSync(filePath, yaml_1.default.stringify(spec), "utf8");
+}
+function updateSpecServerUrls(specFiles, env) {
+    for (const filePath of specFiles) {
+        const apiName = (0, auth_1.getApiNameFromFile)(filePath);
+        if (!apiName) {
+            continue;
+        }
+        const newUrl = resolveServerUrl(apiName, env);
+        if (!newUrl) {
+            continue;
+        }
+        const parsed = readSpecFile(filePath);
+        if (!parsed || !parsed.spec || typeof parsed.spec !== "object") {
+            continue;
+        }
+        const spec = parsed.spec;
+        const updated = applyServerUrlToSpec(spec, newUrl);
+        if (updated) {
+            writeSpecFile(filePath, spec, parsed.format);
+        }
+    }
+}
+function resolveServerUrl(apiName, env) {
+    const envKey = `${apiName.toUpperCase()}_SERVER_URL`;
+    const envValue = env[envKey];
+    if (typeof envValue === "string" && envValue.trim()) {
+        return envValue.trim();
+    }
+    return null;
+}
+function isSwagger2Spec(spec) {
+    return Boolean(spec && typeof spec === "object" && spec.swagger === "2.0");
+}
+function isOpenApi3Spec(spec) {
+    return Boolean(spec && typeof spec === "object" && spec.openapi);
+}
+function applyServerUrlToSpec(spec, newUrl) {
+    let updated = false;
+    if (isSwagger2Spec(spec)) {
+        updated = applySwagger2ServerUrl(spec, newUrl) || updated;
+    }
+    else if (isOpenApi3Spec(spec)) {
+        updated = applyOpenApi3ServerUrl(spec, newUrl) || updated;
+    }
+    return updated;
+}
+function applyOpenApi3ServerUrl(spec, newUrl) {
+    let updated = false;
+    if (Array.isArray(spec.servers) && spec.servers.length > 0) {
+        const first = spec.servers[0];
+        if (!first || typeof first !== "object" || first.url !== newUrl) {
+            spec.servers[0] = { ...(first || {}), url: newUrl };
+            updated = true;
+        }
+    }
+    else {
+        spec.servers = [{ url: newUrl }];
+        updated = true;
+    }
+    return updated;
+}
+function applySwagger2ServerUrl(spec, newUrl) {
+    let updated = false;
+    const parsedUrl = safeParseUrl(newUrl);
+    if (parsedUrl) {
+        const scheme = parsedUrl.protocol.replace(":", "");
+        const host = parsedUrl.host;
+        const hasPath = parsedUrl.pathname && parsedUrl.pathname !== "/";
+        const basePath = hasPath ? parsedUrl.pathname : spec.basePath;
+        if (scheme &&
+            (!Array.isArray(spec.schemes) || spec.schemes[0] !== scheme)) {
+            spec.schemes = [scheme];
+            updated = true;
+        }
+        if (host && spec.host !== host) {
+            spec.host = host;
+            updated = true;
+        }
+        if (hasPath && spec.basePath !== basePath) {
+            spec.basePath = basePath;
+            updated = true;
+        }
+    }
+    if (spec.servers) {
+        delete spec.servers;
+        updated = true;
+    }
+    return updated;
+}
+function safeParseUrl(rawUrl) {
+    try {
+        return new URL(rawUrl);
+    }
+    catch {
+        return null;
+    }
+}
+function isOpenAPIFile(filePath) {
+    const ext = path_1.default.extname(filePath).toLowerCase();
+    const filename = path_1.default.basename(filePath).toLowerCase();
+    // Only accept certain extensions
+    if (![".json", ".yaml", ".yml"].includes(ext)) {
+        return false;
+    }
+    // Skip common non-OpenAPI files
+    const skipFiles = [
+        "package.json",
+        "package-lock.json",
+        "tsconfig.json",
+        ".eslintrc.json",
+        "jest.config.json",
+    ];
+    if (skipFiles.includes(filename)) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/utils/openapi-parser.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "specrun",
+  "version": "1.0.0",
+  "description": "An MCP server that converts OpenAPI specifications to MCP tools - scan a folder for spec files and automatically generate corresponding tools",
+  "main": "dist/index.js",
+  "bin": {
+    "specrun": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "dev": "tsx src/cli.ts",
+    "dev:watch": "tsx watch src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "npm run build && node dist/cli.js --help",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "openapi",
+    "swagger",
+    "api",
+    "tools",
+    "spec",
+    "fastmcp",
+    "runner",
+    "generator"
+  ],
+  "author": "Pavel Piha",
+  "types": "dist/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:Pavel-Piha/specrun.git"
+  },
+  "files": [
+    "dist",
+    "specs",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^12.1.0",
+    "axios": "^1.13.5",
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "fastmcp": "^3.32.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

package/specs/.env

@@ -0,0 +1,20 @@
+# Example authentication configuration
+
+# API Key authentication (X-API-Key header)
+CARS_API_KEY=your_cars_api_key_here
+
+# Bearer token authentication
+GITHUB_TOKEN=ghp_your_github_personal_access_token
+OPENAI_API_KEY=sk-your_openai_api_key
+
+# Basic authentication (username + password)
+MYAPI_USERNAME=your_username
+MYAPI_PASSWORD=your_password
+
+# SpecRun placeholders
+CARS_SERVER_URL=
+CARS_BEARER_TOKEN=
+GITHUB_SERVER_URL=
+GITHUB_BEARER_TOKEN=
+OBJECTS_SERVER_URL=
+OBJECTS_BEARER_TOKEN=

package/specs/cars.swagger.json

@@ -0,0 +1,105 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "Cars API",
+    "version": "1.0.0",
+    "description": "A simple API for managing cars"
+  },
+  "servers": [
+    {
+      "url": "https://api-server.placeholder"
+    }
+  ],
+  "paths": {
+    "/cars/{carId}": {
+      "get": {
+        "operationId": "getCarById",
+        "summary": "Find car by ID",
+        "description": "Returns a single car",
+        "parameters": [
+          {
+            "name": "carId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            },
+            "description": "ID of car to return"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation"
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "404": {
+            "description": "Car not found"
+          }
+        }
+      }
+    },
+    "/cars": {
+      "post": {
+        "operationId": "addCar",
+        "summary": "Add a new car",
+        "description": "Add a new car to the catalog",
+        "requestBody": {
+          "description": "Create a new car in the catalog",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["make", "model", "year"],
+                "properties": {
+                  "make": {
+                    "type": "string",
+                    "example": "Toyota"
+                  },
+                  "model": {
+                    "type": "string",
+                    "example": "Corolla"
+                  },
+                  "year": {
+                    "type": "integer",
+                    "format": "int32",
+                    "example": 2022
+                  },
+                  "status": {
+                    "type": "string",
+                    "description": "car status in the catalog",
+                    "enum": ["available", "reserved", "sold"]
+                  }
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Successful operation"
+          },
+          "405": {
+            "description": "Invalid input"
+          }
+        }
+      }
+    },
+    "/inventory": {
+      "get": {
+        "operationId": "getInventory",
+        "summary": "Returns car inventory by status",
+        "description": "Returns a map of status codes to quantities",
+        "responses": {
+          "200": {
+            "description": "successful operation"
+          }
+        }
+      }
+    }
+  },
+  "x-base-url": "https://api-server.placeholder"
+}