openapi-mcp-gen 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 openapi-to-mcp contributors
+
+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 ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 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,202 @@
+# openapi-to-mcp
+
+Generate a fully working **MCP (Model Context Protocol) server** from any OpenAPI 3.x spec — JSON or YAML, local file or URL.
+
+One command turns your REST API into an AI-ready MCP server with proper tool definitions, input validation, authentication, and error handling.
+
+## Install
+
+```bash
+npm install -g openapi-to-mcp
+# or use without installing:
+npx openapi-to-mcp ./petstore.yaml
+```
+
+## Quick Start
+
+```bash
+# From a local file
+npx openapi-to-mcp ./petstore.yaml --output ./petstore-mcp
+
+# From a URL
+npx openapi-to-mcp https://petstore3.swagger.io/api/v3/openapi.json -o ./petstore-mcp
+
+# Preview tools without generating files
+npx openapi-to-mcp ./petstore.yaml --list-tools
+
+# Dry run (parse only, no output)
+npx openapi-to-mcp ./petstore.yaml --dry-run
+```
+
+## What Gets Generated
+
+Given this input:
+
+```yaml
+# petstore.yaml (OpenAPI 3.0)
+openapi: "3.0.0"
+info:
+  title: Petstore
+  version: "1.0.0"
+servers:
+  - url: https://petstore3.swagger.io/api/v3
+paths:
+  /pet/{petId}:
+    get:
+      operationId: getPetById
+      summary: Find pet by ID
+      parameters:
+        - name: petId
+          in: path
+          required: true
+          schema:
+            type: integer
+```
+
+You get a ready-to-run MCP server:
+
+```
+petstore-mcp/
+├── src/
+│   └── server.ts      # MCP server with all tools
+├── package.json
+├── tsconfig.json
+├── .env.example
+└── README.md
+```
+
+Then:
+
+```bash
+cd petstore-mcp
+npm install
+npm run build
+node dist/server.js
+```
+
+## CLI Reference
+
+```
+openapi-to-mcp <spec> [options]
+
+Arguments:
+  spec                  Path or URL to an OpenAPI 3.x spec (JSON or YAML)
+
+Options:
+  -o, --output <dir>    Output directory (default: ./mcp-server)
+  --dry-run             Parse and show info, do not write files
+  --list-tools          Print all tools that would be generated, then exit
+  -V, --version         Show version
+  -h, --help            Show help
+```
+
+## Authentication
+
+`openapi-to-mcp` auto-detects auth from `securitySchemes` and generates the appropriate environment variable handling.
+
+| Scheme | Detected as | Env var | Behaviour |
+|--------|------------|---------|-----------|
+| `http` + `bearer` | Bearer token | `API_BEARER_TOKEN` | `Authorization: Bearer $TOKEN` |
+| `http` + `basic` | Basic auth | `API_BASIC_CREDENTIALS` | `Authorization: Basic $CREDS` |
+| `apiKey` | API key | `API_KEY` | Header / query / cookie |
+| (none) | No auth | — | No auth header added |
+
+The generated server exits with a clear error message if a required env var is missing.
+
+## Generated Server
+
+The generated `src/server.ts`:
+
+- Uses the official `@modelcontextprotocol/sdk` package
+- Runs on **stdio** transport (standard for MCP)
+- Creates **one tool per API endpoint** (named by `operationId` or derived from method + path)
+- Validates inputs via MCP's built-in schema support
+- Calls the real API with `fetch`, including auth
+- Returns human-readable errors on HTTP failures
+- Flattens JSON request body top-level properties into tool parameters for ergonomic use
+
+## OpenAPI Feature Support
+
+| Feature | Support |
+|---------|---------|
+| OpenAPI 3.0.x | ✅ |
+| OpenAPI 3.1.x | ✅ |
+| YAML specs | ✅ |
+| JSON specs | ✅ |
+| Remote URL specs | ✅ |
+| Path parameters | ✅ |
+| Query parameters | ✅ |
+| Header parameters | ✅ |
+| Request body (JSON) | ✅ |
+| Bearer auth | ✅ |
+| API key auth | ✅ |
+| Basic auth | ✅ |
+| `$ref` resolution | ✅ (local refs) |
+| Deprecated endpoints | ✅ (annotated) |
+| Duplicate operationIds | ✅ (auto-suffixed) |
+
+## Using with Claude Desktop
+
+Add the generated server to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "petstore": {
+      "command": "node",
+      "args": ["/absolute/path/to/petstore-mcp/dist/server.js"],
+      "env": {
+        "API_BEARER_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+## Using with Claude Code
+
+```bash
+claude mcp add petstore -- node /absolute/path/to/petstore-mcp/dist/server.js
+```
+
+With environment variables:
+
+```bash
+claude mcp add petstore \
+  -e API_BEARER_TOKEN=your-token \
+  -- node /absolute/path/to/petstore-mcp/dist/server.js
+```
+
+## Example: GitHub API
+
+```bash
+npx openapi-to-mcp https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.yaml \
+  --output ./github-mcp
+
+cd github-mcp
+npm install && npm run build
+export API_BEARER_TOKEN=ghp_your_token
+node dist/server.js
+```
+
+## Recommended Models
+
+When using your generated MCP server with Claude, these model IDs are confirmed compatible:
+
+- `claude-haiku-4.5` — fast, low-cost, great for simple API calls
+- `claude-sonnet-4-6` — balanced performance (recommended default)
+- `claude-opus-4-6` — most capable, best for complex multi-step API workflows
+
+## Contributing
+
+Pull requests welcome. The core pipeline is:
+
+1. `src/parser.ts` — loads and parses the OpenAPI spec into a clean domain model
+2. `src/generator.ts` — maps the parsed spec to template data and writes files
+3. `src/templates.ts` — Handlebars rendering helpers
+4. `templates/server.ts.hbs` — the MCP server template
+5. `templates/package.json.hbs` — generated project package.json template
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,526 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import path4 from "path";
+
+// src/parser.ts
+import fs from "fs-extra";
+import yaml from "js-yaml";
+import path from "path";
+var HTTP_METHODS = ["get", "post", "put", "patch", "delete", "head", "options"];
+function toCamelCase(str) {
+  return str.replace(/[-_\s]+(.)/g, (_, c) => c.toUpperCase()).replace(/^(.)/, (c) => c.toLowerCase());
+}
+function toSafeIdentifier(str) {
+  const cleaned = str.replace(/[^a-zA-Z0-9_]/g, "_").replace(/_+/g, "_");
+  return toCamelCase(cleaned);
+}
+function deriveToolName(method, urlPath, operationId) {
+  if (operationId && operationId.trim()) {
+    return toSafeIdentifier(operationId.trim());
+  }
+  const segments = urlPath.split("/").filter(Boolean).map((s) => s.replace(/\{([^}]+)\}/, "By_$1")).map((s) => s.replace(/[^a-zA-Z0-9]/g, "_"));
+  const name = [method, ...segments].join("_");
+  return toSafeIdentifier(name);
+}
+function resolveRef(spec, ref) {
+  const parts = ref.replace(/^#\//, "").split("/");
+  let node = spec;
+  for (const part of parts) {
+    node = node?.[part];
+  }
+  return node ?? { type: "object" };
+}
+function resolveSchema(spec, schema) {
+  if (!schema) return { type: "object" };
+  if (schema["$ref"]) return resolveRef(spec, schema["$ref"]);
+  return schema;
+}
+function parseParam(spec, raw) {
+  const schema = resolveSchema(spec, raw.schema ?? { type: "string" });
+  return {
+    name: raw.name,
+    camelName: toCamelCase(raw.name),
+    in: raw.in,
+    description: raw.description ?? "",
+    required: raw.required ?? false,
+    schema
+  };
+}
+function detectAuth(spec) {
+  const schemes = spec.components?.securitySchemes ?? {};
+  for (const [, scheme] of Object.entries(schemes)) {
+    if (scheme.type === "http" && scheme.scheme === "bearer") {
+      return {
+        type: "bearer",
+        paramName: "Authorization",
+        paramIn: "header",
+        envVar: "API_BEARER_TOKEN",
+        description: scheme.description ?? "Bearer token authentication"
+      };
+    }
+    if (scheme.type === "http" && scheme.scheme === "basic") {
+      return {
+        type: "basic",
+        paramName: "Authorization",
+        paramIn: "header",
+        envVar: "API_BASIC_CREDENTIALS",
+        description: scheme.description ?? "Basic authentication (base64 user:pass)"
+      };
+    }
+    if (scheme.type === "apiKey") {
+      const paramIn = scheme.in ?? "header";
+      const paramName = scheme.name ?? "X-API-Key";
+      return {
+        type: "apiKey",
+        paramName,
+        paramIn,
+        envVar: "API_KEY",
+        description: scheme.description ?? `API key sent in ${paramIn} as "${paramName}"`
+      };
+    }
+  }
+  return {
+    type: "none",
+    paramName: "",
+    paramIn: "header",
+    envVar: "",
+    description: "No authentication"
+  };
+}
+function parseEndpoint(spec, urlPath, method, op, pathLevelParams) {
+  const rawParams = [...pathLevelParams];
+  for (const p of op.parameters ?? []) {
+    const resolved = p["$ref"] ? resolveRef(spec, p["$ref"]) : p;
+    const existing = rawParams.findIndex(
+      (x) => x.name === resolved.name && x.in === resolved.in
+    );
+    if (existing >= 0) rawParams[existing] = resolved;
+    else rawParams.push(resolved);
+  }
+  const parsedParams = rawParams.map((p) => parseParam(spec, p));
+  const pathParams = parsedParams.filter((p) => p.in === "path");
+  const queryParams = parsedParams.filter((p) => p.in === "query");
+  const headerParams = parsedParams.filter((p) => p.in === "header");
+  let hasBody = false;
+  let bodyRequired = false;
+  let bodyContentType = "application/json";
+  let bodySchema = null;
+  if (op.requestBody) {
+    const rb = op.requestBody;
+    hasBody = true;
+    bodyRequired = rb.required ?? false;
+    const contentTypes = Object.keys(rb.content ?? {});
+    bodyContentType = contentTypes.find((ct) => ct.includes("json")) ?? contentTypes[0] ?? "application/json";
+    const mediaType = rb.content?.[bodyContentType];
+    if (mediaType?.schema) {
+      bodySchema = resolveSchema(spec, mediaType.schema);
+    }
+  }
+  const allRequired = [
+    ...pathParams.filter((p) => p.required).map((p) => p.name),
+    ...queryParams.filter((p) => p.required).map((p) => p.name),
+    ...headerParams.filter((p) => p.required).map((p) => p.name)
+  ];
+  if (hasBody && bodyRequired) allRequired.push("body");
+  const operationId = op.operationId ?? "";
+  const toolName = deriveToolName(method, urlPath, operationId);
+  return {
+    toolName,
+    operationId,
+    method,
+    path: urlPath,
+    summary: op.summary ?? "",
+    description: op.description ?? op.summary ?? "",
+    tags: op.tags ?? [],
+    deprecated: op.deprecated ?? false,
+    pathParams,
+    queryParams,
+    headerParams,
+    hasBody,
+    bodyRequired,
+    bodyContentType,
+    bodySchema,
+    allRequired
+  };
+}
+async function loadSpec(input) {
+  let raw;
+  if (input.startsWith("http://") || input.startsWith("https://")) {
+    const res = await fetch(input);
+    if (!res.ok) {
+      throw new Error(`Failed to fetch spec: ${res.status} ${res.statusText}`);
+    }
+    raw = await res.text();
+  } else {
+    const resolved = path.resolve(input);
+    if (!fs.existsSync(resolved)) {
+      throw new Error(`Spec file not found: ${resolved}`);
+    }
+    raw = await fs.readFile(resolved, "utf-8");
+  }
+  let spec;
+  const trimmed = raw.trimStart();
+  if (trimmed.startsWith("{")) {
+    spec = JSON.parse(raw);
+  } else {
+    spec = yaml.load(raw);
+  }
+  if (!spec || typeof spec !== "object") {
+    throw new Error("Could not parse spec: result is not an object");
+  }
+  const s = spec;
+  if (!s.openapi) {
+    throw new Error("Not a valid OpenAPI 3.x spec (missing 'openapi' field)");
+  }
+  if (!s.openapi.startsWith("3.")) {
+    throw new Error(`Unsupported OpenAPI version: ${s.openapi} (only 3.x is supported)`);
+  }
+  return s;
+}
+function parseSpec(spec) {
+  const endpoints = [];
+  for (const [urlPath, pathItem] of Object.entries(spec.paths ?? {})) {
+    const pathLevelParams = (pathItem.parameters ?? []).map(
+      (p) => p["$ref"] ? resolveRef(spec, p["$ref"]) : p
+    );
+    for (const method of HTTP_METHODS) {
+      const op = pathItem[method];
+      if (!op) continue;
+      const endpoint = parseEndpoint(spec, urlPath, method, op, pathLevelParams);
+      endpoints.push(endpoint);
+    }
+  }
+  const seen = /* @__PURE__ */ new Map();
+  for (const ep of endpoints) {
+    const count = (seen.get(ep.toolName) ?? 0) + 1;
+    seen.set(ep.toolName, count);
+    if (count > 1) ep.toolName = `${ep.toolName}_${count}`;
+  }
+  const baseUrl = spec.servers?.[0]?.url?.replace(/\/$/, "") ?? "https://api.example.com";
+  return {
+    title: spec.info.title,
+    version: spec.info.version,
+    description: spec.info.description ?? "",
+    baseUrl,
+    endpoints,
+    auth: detectAuth(spec),
+    rawSchemas: spec.components?.schemas ?? {}
+  };
+}
+
+// src/generator.ts
+import path3 from "path";
+import fs3 from "fs-extra";
+
+// src/templates.ts
+import Handlebars from "handlebars";
+import fs2 from "fs-extra";
+import path2 from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = path2.dirname(__filename);
+Handlebars.registerHelper("eq", (a, b) => a === b);
+Handlebars.registerHelper("neq", (a, b) => a !== b);
+Handlebars.registerHelper("and", (a, b) => Boolean(a) && Boolean(b));
+Handlebars.registerHelper("or", (a, b) => Boolean(a) || Boolean(b));
+Handlebars.registerHelper("not", (a) => !a);
+Handlebars.registerHelper("gt", (a, b) => a > b);
+Handlebars.registerHelper(
+  "json",
+  (value) => JSON.stringify(value, null, 2)
+);
+Handlebars.registerHelper(
+  "jsonInline",
+  (value) => JSON.stringify(value)
+);
+Handlebars.registerHelper(
+  "ucFirst",
+  (s) => s ? s.charAt(0).toUpperCase() + s.slice(1) : ""
+);
+function getTemplatesRoot() {
+  const candidates = [
+    path2.resolve(__dirname, "..", "templates"),
+    path2.resolve(__dirname, "..", "..", "templates")
+  ];
+  for (const candidate of candidates) {
+    if (fs2.existsSync(candidate)) return candidate;
+  }
+  throw new Error(
+    "Templates directory not found. Searched: " + candidates.join(", ")
+  );
+}
+function renderTemplate(templateFile, data) {
+  const templatesRoot = getTemplatesRoot();
+  const templatePath = path2.join(templatesRoot, templateFile);
+  if (!fs2.existsSync(templatePath)) {
+    throw new Error(`Template file not found: ${templatePath}`);
+  }
+  const raw = fs2.readFileSync(templatePath, "utf-8");
+  const compiled = Handlebars.compile(raw, { noEscape: true });
+  return compiled(data);
+}
+
+// src/generator.ts
+function buildJsonSchema(schema) {
+  if (!schema) return { type: "object" };
+  const result = {};
+  if (schema.type) result.type = schema.type;
+  if (schema.description) result.description = schema.description;
+  if (schema.enum) result.enum = schema.enum;
+  if (schema.default !== void 0) result.default = schema.default;
+  if (schema.format) result.format = schema.format;
+  if (schema.minimum !== void 0) result.minimum = schema.minimum;
+  if (schema.maximum !== void 0) result.maximum = schema.maximum;
+  if (schema.minLength !== void 0) result.minLength = schema.minLength;
+  if (schema.maxLength !== void 0) result.maxLength = schema.maxLength;
+  if (schema.pattern) result.pattern = schema.pattern;
+  if (schema.properties) {
+    result.type = result.type ?? "object";
+    result.properties = Object.fromEntries(
+      Object.entries(schema.properties).map(([k, v]) => [k, buildJsonSchema(v)])
+    );
+    if (schema.required) result.required = schema.required;
+  }
+  if (schema.items) {
+    result.type = result.type ?? "array";
+    result.items = buildJsonSchema(schema.items);
+  }
+  if (schema.allOf) {
+    result.allOf = schema.allOf.map(buildJsonSchema);
+  }
+  if (schema.oneOf) {
+    result.oneOf = schema.oneOf.map(buildJsonSchema);
+  }
+  if (schema.anyOf) {
+    result.anyOf = schema.anyOf.map(buildJsonSchema);
+  }
+  if (result.type === void 0 && !schema.properties && !schema.items) {
+    result.type = "string";
+  }
+  return result;
+}
+function paramToJsonSchemaProp(param) {
+  const base = buildJsonSchema(param.schema);
+  if (param.description && !base.description) {
+    base.description = param.description;
+  }
+  return base;
+}
+function buildInputSchema(ep) {
+  const properties = {};
+  const required = [];
+  for (const p of ep.pathParams) {
+    properties[p.name] = {
+      ...paramToJsonSchemaProp(p),
+      description: (p.description ? p.description + " " : "") + `(path parameter)`
+    };
+    if (p.required) required.push(p.name);
+  }
+  for (const p of ep.queryParams) {
+    properties[p.name] = {
+      ...paramToJsonSchemaProp(p),
+      description: (p.description ? p.description + " " : "") + `(query parameter)`
+    };
+    if (p.required) required.push(p.name);
+  }
+  for (const p of ep.headerParams) {
+    properties[p.name] = {
+      ...paramToJsonSchemaProp(p),
+      description: (p.description ? p.description + " " : "") + `(header parameter)`
+    };
+    if (p.required) required.push(p.name);
+  }
+  if (ep.hasBody) {
+    if (ep.bodySchema?.properties) {
+      for (const [key, propSchema] of Object.entries(ep.bodySchema.properties)) {
+        properties[key] = buildJsonSchema(propSchema);
+        if (ep.bodySchema.required?.includes(key)) required.push(key);
+      }
+    } else {
+      properties["body"] = ep.bodySchema ? buildJsonSchema(ep.bodySchema) : { type: "object", description: "Request body" };
+      if (ep.bodyRequired) required.push("body");
+    }
+  }
+  return { type: "object", properties, required };
+}
+function buildToolData(ep) {
+  const inputSchema = buildInputSchema(ep);
+  const bodyHasTopLevelProps = Boolean(ep.bodySchema?.properties);
+  const bodyProps = bodyHasTopLevelProps ? Object.keys(ep.bodySchema.properties) : [];
+  return {
+    toolName: ep.toolName,
+    description: [ep.summary, ep.description].filter(Boolean).filter((v, i, a) => a.indexOf(v) === i).join(" \u2014 ").slice(0, 1024) || ep.path,
+    inputSchemaJson: JSON.stringify(inputSchema, null, 4),
+    method: ep.method.toUpperCase(),
+    urlPath: ep.path,
+    pathParams: ep.pathParams.map((p) => p.name),
+    pathReplacements: ep.pathParams.map((p) => ({
+      placeholder: `{${p.name}}`,
+      paramName: p.name
+    })),
+    queryParams: ep.queryParams.map((p) => p.name),
+    headerParams: ep.headerParams.map((p) => p.name),
+    hasBody: ep.hasBody,
+    bodyHasTopLevelProps,
+    bodyProps,
+    bodyContentType: ep.bodyContentType,
+    deprecated: ep.deprecated
+  };
+}
+async function generate(spec, options) {
+  const { outputDir } = options;
+  await fs3.ensureDir(outputDir);
+  await fs3.ensureDir(path3.join(outputDir, "src"));
+  const tools = spec.endpoints.map(buildToolData);
+  const serverName = spec.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "openapi-mcp";
+  const templateData = {
+    serverName,
+    serverTitle: spec.title,
+    serverVersion: spec.info ? spec.version : "1.0.0",
+    serverDescription: spec.description || spec.title,
+    baseUrl: spec.baseUrl,
+    tools,
+    toolCount: tools.length,
+    auth: spec.auth,
+    hasAuth: spec.auth.type !== "none",
+    isBearer: spec.auth.type === "bearer",
+    isApiKey: spec.auth.type === "apiKey",
+    isBasic: spec.auth.type === "basic",
+    apiKeyInHeader: spec.auth.paramIn === "header",
+    apiKeyInQuery: spec.auth.paramIn === "query"
+  };
+  const serverCode = renderTemplate("server.ts.hbs", templateData);
+  await fs3.writeFile(path3.join(outputDir, "src", "server.ts"), serverCode, "utf-8");
+  const pkgJson = renderTemplate("package.json.hbs", templateData);
+  await fs3.writeFile(path3.join(outputDir, "package.json"), pkgJson, "utf-8");
+  const tsconfigContent = JSON.stringify(
+    {
+      compilerOptions: {
+        target: "ES2022",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        strict: true,
+        esModuleInterop: true,
+        skipLibCheck: true,
+        outDir: "dist",
+        rootDir: "src",
+        resolveJsonModule: true
+      },
+      include: ["src"],
+      exclude: ["node_modules", "dist"]
+    },
+    null,
+    2
+  );
+  await fs3.writeFile(
+    path3.join(outputDir, "tsconfig.json"),
+    tsconfigContent,
+    "utf-8"
+  );
+  const envLines = ["# Generated by openapi-to-mcp", ""];
+  if (spec.auth.type !== "none") {
+    envLines.push(`# ${spec.auth.description}`);
+    envLines.push(`${spec.auth.envVar}=`);
+    envLines.push("");
+  }
+  envLines.push("# Override the base URL if needed");
+  envLines.push(`BASE_URL=${spec.baseUrl}`);
+  envLines.push("");
+  await fs3.writeFile(
+    path3.join(outputDir, ".env.example"),
+    envLines.join("\n"),
+    "utf-8"
+  );
+  const readme = buildGeneratedReadme(spec, serverName, tools.length);
+  await fs3.writeFile(path3.join(outputDir, "README.md"), readme, "utf-8");
+}
+function buildGeneratedReadme(spec, serverName, toolCount) {
+  const authSection = spec.auth.type === "none" ? "" : `## Authentication
+
+Set the \`${spec.auth.envVar}\` environment variable:
+
+\`\`\`bash
+export ${spec.auth.envVar}=your_token_here
+\`\`\`
+
+${spec.auth.description}
+`;
+  return `# ${spec.title} MCP Server
+
+Generated by [openapi-to-mcp](https://github.com/example/openapi-to-mcp).
+
+**${spec.description || spec.title}**
+
+- **Base URL:** \`${spec.baseUrl}\`
+- **Tools:** ${toolCount}
+
+## Quick Start
+
+\`\`\`bash
+npm install
+npm run build
+node dist/server.js
+\`\`\`
+
+${authSection}
+## Usage with Claude Desktop
+
+Add to your \`claude_desktop_config.json\`:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "${serverName}": {
+      "command": "node",
+      "args": ["/absolute/path/to/${serverName}/dist/server.js"]${spec.auth.type !== "none" ? `,
+      "env": {
+        "${spec.auth.envVar}": "your_token_here"
+      }` : ""}
+    }
+  }
+}
+\`\`\`
+
+## Available Tools (${toolCount})
+
+| Tool | Method | Path | Description |
+|------|--------|------|-------------|
+${spec.endpoints.map(
+    (ep) => `| \`${ep.toolName}\` | \`${ep.method.toUpperCase()}\` | \`${ep.path}\` | ${ep.summary || ep.description || ""} |`
+  ).join("\n")}
+`;
+}
+
+// src/index.ts
+var program = new Command();
+program.name("mcp-from-openapi").description("Generate a fully working MCP server from an OpenAPI 3.x spec").version("1.0.0").argument("<spec>", "Path or URL to OpenAPI 3.x spec (JSON or YAML)").option("-o, --output <dir>", "Output directory for generated MCP server", "./mcp-server").action(async (specPath, opts) => {
+  try {
+    console.log(chalk.blue("Loading OpenAPI spec:"), specPath);
+    const spec = await loadSpec(specPath);
+    const parsed = parseSpec(spec);
+    console.log(chalk.green("Found"), `${parsed.endpoints.length} endpoints`);
+    if (parsed.auth) {
+      console.log(chalk.green("Auth:"), `${parsed.auth.type} (${parsed.auth.envVar})`);
+    }
+    const outputDir = path4.resolve(opts.output);
+    console.log(chalk.blue("Generating MCP server to:"), outputDir);
+    await generate(parsed, { outputDir });
+    console.log("");
+    console.log(chalk.green.bold("MCP server generated successfully!"));
+    console.log("");
+    console.log("Next steps:");
+    console.log(chalk.dim(`  cd ${opts.output}`));
+    console.log(chalk.dim("  npm install"));
+    console.log(chalk.dim("  npm run build"));
+    console.log(chalk.dim("  npm start"));
+    console.log("");
+  } catch (err) {
+    console.error(chalk.red("Error:"), err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/parser.ts","../src/generator.ts","../src/templates.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport chalk from \"chalk\";\nimport path from \"node:path\";\nimport { loadSpec, parseSpec } from \"./parser.js\";\nimport { generate } from \"./generator.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"mcp-from-openapi\")\n  .description(\"Generate a fully working MCP server from an OpenAPI 3.x spec\")\n  .version(\"1.0.0\")\n  .argument(\"<spec>\", \"Path or URL to OpenAPI 3.x spec (JSON or YAML)\")\n  .option(\"-o, --output <dir>\", \"Output directory for generated MCP server\", \"./mcp-server\")\n  .action(async (specPath: string, opts: { output: string }) => {\n    try {\n      console.log(chalk.blue(\"Loading OpenAPI spec:\"), specPath);\n\n      const spec = await loadSpec(specPath);\n      const parsed = parseSpec(spec);\n\n      console.log(chalk.green(\"Found\"), `${parsed.endpoints.length} endpoints`);\n      if (parsed.auth) {\n        console.log(chalk.green(\"Auth:\"), `${parsed.auth.type} (${parsed.auth.envVar})`);\n      }\n\n      const outputDir = path.resolve(opts.output);\n      console.log(chalk.blue(\"Generating MCP server to:\"), outputDir);\n\n      await generate(parsed, { outputDir });\n\n      console.log(\"\");\n      console.log(chalk.green.bold(\"MCP server generated successfully!\"));\n      console.log(\"\");\n      console.log(\"Next steps:\");\n      console.log(chalk.dim(`  cd ${opts.output}`));\n      console.log(chalk.dim(\"  npm install\"));\n      console.log(chalk.dim(\"  npm run build\"));\n      console.log(chalk.dim(\"  npm start\"));\n      console.log(\"\");\n    } catch (err) {\n      console.error(chalk.red(\"Error:\"), err instanceof Error ? err.message : err);\n      process.exit(1);\n    }\n  });\n\nprogram.parse();\n","import fs from \"fs-extra\";\nimport yaml from \"js-yaml\";\nimport path from \"node:path\";\n\n// ─── OpenAPI 3.x types (minimal subset we care about) ────────────────────────\n\nexport interface OpenAPISpec {\n  openapi: string;\n  info: { title: string; version: string; description?: string };\n  servers?: Array<{ url: string; description?: string }>;\n  paths?: Record<string, PathItem>;\n  components?: {\n    schemas?: Record<string, SchemaObject>;\n    securitySchemes?: Record<string, SecurityScheme>;\n  };\n  security?: SecurityRequirement[];\n}\n\nexport type HttpMethod = \"get\" | \"post\" | \"put\" | \"patch\" | \"delete\" | \"head\" | \"options\";\n\nexport interface PathItem {\n  get?: OperationObject;\n  post?: OperationObject;\n  put?: OperationObject;\n  patch?: OperationObject;\n  delete?: OperationObject;\n  head?: OperationObject;\n  options?: OperationObject;\n  parameters?: ParameterObject[];\n}\n\nexport interface OperationObject {\n  operationId?: string;\n  summary?: string;\n  description?: string;\n  tags?: string[];\n  parameters?: ParameterObject[];\n  requestBody?: RequestBodyObject;\n  responses?: Record<string, ResponseObject>;\n  security?: SecurityRequirement[];\n  deprecated?: boolean;\n}\n\nexport interface ParameterObject {\n  name: string;\n  in: \"query\" | \"path\" | \"header\" | \"cookie\";\n  description?: string;\n  required?: boolean;\n  schema?: SchemaObject;\n  \"$ref\"?: string;\n}\n\nexport interface RequestBodyObject {\n  description?: string;\n  required?: boolean;\n  content: Record<string, { schema?: SchemaObject }>;\n}\n\nexport interface ResponseObject {\n  description?: string;\n  content?: Record<string, { schema?: SchemaObject }>;\n}\n\nexport interface SchemaObject {\n  type?: string;\n  format?: string;\n  description?: string;\n  properties?: Record<string, SchemaObject>;\n  items?: SchemaObject;\n  required?: string[];\n  enum?: unknown[];\n  default?: unknown;\n  nullable?: boolean;\n  allOf?: SchemaObject[];\n  oneOf?: SchemaObject[];\n  anyOf?: SchemaObject[];\n  \"$ref\"?: string;\n  additionalProperties?: boolean | SchemaObject;\n  minimum?: number;\n  maximum?: number;\n  minLength?: number;\n  maxLength?: number;\n  pattern?: string;\n  example?: unknown;\n}\n\nexport interface SecurityScheme {\n  type: \"apiKey\" | \"http\" | \"oauth2\" | \"openIdConnect\";\n  scheme?: string; // for type=http: \"bearer\", \"basic\"\n  in?: \"header\" | \"query\" | \"cookie\"; // for type=apiKey\n  name?: string; // for type=apiKey\n  description?: string;\n  flows?: Record<string, unknown>;\n}\n\nexport type SecurityRequirement = Record<string, string[]>;\n\n// ─── Parsed domain types ──────────────────────────────────────────────────────\n\nexport interface ParsedEndpoint {\n  /** Sanitised identifier, e.g. \"getPetById\" */\n  toolName: string;\n  /** Original operationId (may be empty) */\n  operationId: string;\n  method: HttpMethod;\n  path: string;\n  summary: string;\n  description: string;\n  tags: string[];\n  deprecated: boolean;\n  pathParams: ParsedParam[];\n  queryParams: ParsedParam[];\n  headerParams: ParsedParam[];\n  hasBody: boolean;\n  bodyRequired: boolean;\n  bodyContentType: string;\n  bodySchema: SchemaObject | null;\n  allRequired: string[];\n}\n\nexport interface ParsedParam {\n  name: string;\n  camelName: string;\n  in: \"query\" | \"path\" | \"header\" | \"cookie\";\n  description: string;\n  required: boolean;\n  schema: SchemaObject;\n}\n\nexport type AuthType = \"apiKey\" | \"bearer\" | \"basic\" | \"none\";\n\nexport interface ParsedAuth {\n  type: AuthType;\n  /** For apiKey: header/query/cookie name */\n  paramName: string;\n  /** For apiKey: where the key is sent */\n  paramIn: \"header\" | \"query\" | \"cookie\";\n  envVar: string;\n  description: string;\n}\n\nexport interface ParsedSpec {\n  title: string;\n  version: string;\n  description: string;\n  baseUrl: string;\n  endpoints: ParsedEndpoint[];\n  auth: ParsedAuth;\n  rawSchemas: Record<string, SchemaObject>;\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nconst HTTP_METHODS: HttpMethod[] = [\"get\", \"post\", \"put\", \"patch\", \"delete\", \"head\", \"options\"];\n\nfunction toCamelCase(str: string): string {\n  return str\n    .replace(/[-_\\s]+(.)/g, (_, c: string) => c.toUpperCase())\n    .replace(/^(.)/, (c: string) => c.toLowerCase());\n}\n\nfunction toSafeIdentifier(str: string): string {\n  // Replace non-alphanumeric chars with underscores, then camelCase\n  const cleaned = str.replace(/[^a-zA-Z0-9_]/g, \"_\").replace(/_+/g, \"_\");\n  return toCamelCase(cleaned);\n}\n\nfunction deriveToolName(method: HttpMethod, urlPath: string, operationId?: string): string {\n  if (operationId && operationId.trim()) {\n    return toSafeIdentifier(operationId.trim());\n  }\n  // Generate from method + path segments\n  const segments = urlPath\n    .split(\"/\")\n    .filter(Boolean)\n    .map((s) => s.replace(/\\{([^}]+)\\}/, \"By_$1\"))\n    .map((s) => s.replace(/[^a-zA-Z0-9]/g, \"_\"));\n  const name = [method, ...segments].join(\"_\");\n  return toSafeIdentifier(name);\n}\n\nfunction resolveRef(spec: OpenAPISpec, ref: string): SchemaObject {\n  // Only supports local $ref: \"#/components/schemas/Foo\"\n  const parts = ref.replace(/^#\\//, \"\").split(\"/\");\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let node: any = spec;\n  for (const part of parts) {\n    node = node?.[part];\n  }\n  return (node as SchemaObject) ?? { type: \"object\" };\n}\n\nfunction resolveSchema(spec: OpenAPISpec, schema?: SchemaObject): SchemaObject {\n  if (!schema) return { type: \"object\" };\n  if (schema[\"$ref\"]) return resolveRef(spec, schema[\"$ref\"]);\n  return schema;\n}\n\nfunction parseParam(spec: OpenAPISpec, raw: ParameterObject): ParsedParam {\n  const schema = resolveSchema(spec, raw.schema ?? { type: \"string\" });\n  return {\n    name: raw.name,\n    camelName: toCamelCase(raw.name),\n    in: raw.in as ParsedParam[\"in\"],\n    description: raw.description ?? \"\",\n    required: raw.required ?? false,\n    schema,\n  };\n}\n\nfunction detectAuth(spec: OpenAPISpec): ParsedAuth {\n  const schemes = spec.components?.securitySchemes ?? {};\n\n  for (const [, scheme] of Object.entries(schemes)) {\n    if (scheme.type === \"http\" && scheme.scheme === \"bearer\") {\n      return {\n        type: \"bearer\",\n        paramName: \"Authorization\",\n        paramIn: \"header\",\n        envVar: \"API_BEARER_TOKEN\",\n        description: scheme.description ?? \"Bearer token authentication\",\n      };\n    }\n    if (scheme.type === \"http\" && scheme.scheme === \"basic\") {\n      return {\n        type: \"basic\",\n        paramName: \"Authorization\",\n        paramIn: \"header\",\n        envVar: \"API_BASIC_CREDENTIALS\",\n        description: scheme.description ?? \"Basic authentication (base64 user:pass)\",\n      };\n    }\n    if (scheme.type === \"apiKey\") {\n      const paramIn = (scheme.in ?? \"header\") as \"header\" | \"query\" | \"cookie\";\n      const paramName = scheme.name ?? \"X-API-Key\";\n      return {\n        type: \"apiKey\",\n        paramName,\n        paramIn,\n        envVar: \"API_KEY\",\n        description: scheme.description ?? `API key sent in ${paramIn} as \"${paramName}\"`,\n      };\n    }\n  }\n\n  return {\n    type: \"none\",\n    paramName: \"\",\n    paramIn: \"header\",\n    envVar: \"\",\n    description: \"No authentication\",\n  };\n}\n\nfunction parseEndpoint(\n  spec: OpenAPISpec,\n  urlPath: string,\n  method: HttpMethod,\n  op: OperationObject,\n  pathLevelParams: ParameterObject[]\n): ParsedEndpoint {\n  // Merge path-level params with operation-level (operation overrides)\n  const rawParams: ParameterObject[] = [...pathLevelParams];\n  for (const p of op.parameters ?? []) {\n    const resolved = p[\"$ref\"]\n      ? (resolveRef(spec, p[\"$ref\"]) as ParameterObject)\n      : p;\n    const existing = rawParams.findIndex(\n      (x) => x.name === resolved.name && x.in === resolved.in\n    );\n    if (existing >= 0) rawParams[existing] = resolved;\n    else rawParams.push(resolved);\n  }\n\n  const parsedParams = rawParams.map((p) => parseParam(spec, p));\n  const pathParams = parsedParams.filter((p) => p.in === \"path\");\n  const queryParams = parsedParams.filter((p) => p.in === \"query\");\n  const headerParams = parsedParams.filter((p) => p.in === \"header\");\n\n  // Request body\n  let hasBody = false;\n  let bodyRequired = false;\n  let bodyContentType = \"application/json\";\n  let bodySchema: SchemaObject | null = null;\n\n  if (op.requestBody) {\n    const rb = op.requestBody;\n    hasBody = true;\n    bodyRequired = rb.required ?? false;\n    const contentTypes = Object.keys(rb.content ?? {});\n    // Prefer JSON, fall back to first available\n    bodyContentType =\n      contentTypes.find((ct) => ct.includes(\"json\")) ??\n      contentTypes[0] ??\n      \"application/json\";\n    const mediaType = rb.content?.[bodyContentType];\n    if (mediaType?.schema) {\n      bodySchema = resolveSchema(spec, mediaType.schema);\n    }\n  }\n\n  // Required list for MCP inputSchema\n  const allRequired: string[] = [\n    ...pathParams.filter((p) => p.required).map((p) => p.name),\n    ...queryParams.filter((p) => p.required).map((p) => p.name),\n    ...headerParams.filter((p) => p.required).map((p) => p.name),\n  ];\n  if (hasBody && bodyRequired) allRequired.push(\"body\");\n\n  const operationId = op.operationId ?? \"\";\n  const toolName = deriveToolName(method, urlPath, operationId);\n\n  return {\n    toolName,\n    operationId,\n    method,\n    path: urlPath,\n    summary: op.summary ?? \"\",\n    description: op.description ?? op.summary ?? \"\",\n    tags: op.tags ?? [],\n    deprecated: op.deprecated ?? false,\n    pathParams,\n    queryParams,\n    headerParams,\n    hasBody,\n    bodyRequired,\n    bodyContentType,\n    bodySchema,\n    allRequired,\n  };\n}\n\n// ─── Public API ───────────────────────────────────────────────────────────────\n\nexport async function loadSpec(input: string): Promise<OpenAPISpec> {\n  let raw: string;\n\n  if (input.startsWith(\"http://\") || input.startsWith(\"https://\")) {\n    const res = await fetch(input);\n    if (!res.ok) {\n      throw new Error(`Failed to fetch spec: ${res.status} ${res.statusText}`);\n    }\n    raw = await res.text();\n  } else {\n    const resolved = path.resolve(input);\n    if (!fs.existsSync(resolved)) {\n      throw new Error(`Spec file not found: ${resolved}`);\n    }\n    raw = await fs.readFile(resolved, \"utf-8\");\n  }\n\n  let spec: unknown;\n  const trimmed = raw.trimStart();\n  if (trimmed.startsWith(\"{\")) {\n    spec = JSON.parse(raw);\n  } else {\n    spec = yaml.load(raw);\n  }\n\n  if (!spec || typeof spec !== \"object\") {\n    throw new Error(\"Could not parse spec: result is not an object\");\n  }\n\n  const s = spec as OpenAPISpec;\n  if (!s.openapi) {\n    throw new Error(\"Not a valid OpenAPI 3.x spec (missing 'openapi' field)\");\n  }\n  if (!s.openapi.startsWith(\"3.\")) {\n    throw new Error(`Unsupported OpenAPI version: ${s.openapi} (only 3.x is supported)`);\n  }\n\n  return s;\n}\n\nexport function parseSpec(spec: OpenAPISpec): ParsedSpec {\n  const endpoints: ParsedEndpoint[] = [];\n\n  for (const [urlPath, pathItem] of Object.entries(spec.paths ?? {})) {\n    const pathLevelParams = (pathItem.parameters ?? []).map((p) =>\n      p[\"$ref\"] ? (resolveRef(spec, p[\"$ref\"]) as ParameterObject) : p\n    );\n\n    for (const method of HTTP_METHODS) {\n      const op = pathItem[method];\n      if (!op) continue;\n      const endpoint = parseEndpoint(spec, urlPath, method, op, pathLevelParams);\n      endpoints.push(endpoint);\n    }\n  }\n\n  // Ensure unique tool names — suffix duplicates with _2, _3, …\n  const seen = new Map<string, number>();\n  for (const ep of endpoints) {\n    const count = (seen.get(ep.toolName) ?? 0) + 1;\n    seen.set(ep.toolName, count);\n    if (count > 1) ep.toolName = `${ep.toolName}_${count}`;\n  }\n\n  const baseUrl =\n    spec.servers?.[0]?.url?.replace(/\\/$/, \"\") ?? \"https://api.example.com\";\n\n  return {\n    title: spec.info.title,\n    version: spec.info.version,\n    description: spec.info.description ?? \"\",\n    baseUrl,\n    endpoints,\n    auth: detectAuth(spec),\n    rawSchemas: spec.components?.schemas ?? {},\n  };\n}\n","import path from \"node:path\";\nimport fs from \"fs-extra\";\nimport { renderTemplate } from \"./templates.js\";\nimport type { ParsedSpec, ParsedEndpoint, SchemaObject, ParsedParam } from \"./parser.js\";\n\n// ─── JSON Schema builder from OpenAPI schema ──────────────────────────────────\n\nfunction buildJsonSchema(schema: SchemaObject | null): Record<string, unknown> {\n  if (!schema) return { type: \"object\" };\n\n  const result: Record<string, unknown> = {};\n\n  if (schema.type) result.type = schema.type;\n  if (schema.description) result.description = schema.description;\n  if (schema.enum) result.enum = schema.enum;\n  if (schema.default !== undefined) result.default = schema.default;\n  if (schema.format) result.format = schema.format;\n  if (schema.minimum !== undefined) result.minimum = schema.minimum;\n  if (schema.maximum !== undefined) result.maximum = schema.maximum;\n  if (schema.minLength !== undefined) result.minLength = schema.minLength;\n  if (schema.maxLength !== undefined) result.maxLength = schema.maxLength;\n  if (schema.pattern) result.pattern = schema.pattern;\n\n  if (schema.properties) {\n    result.type = result.type ?? \"object\";\n    result.properties = Object.fromEntries(\n      Object.entries(schema.properties).map(([k, v]) => [k, buildJsonSchema(v)])\n    );\n    if (schema.required) result.required = schema.required;\n  }\n\n  if (schema.items) {\n    result.type = result.type ?? \"array\";\n    result.items = buildJsonSchema(schema.items);\n  }\n\n  if (schema.allOf) {\n    result.allOf = schema.allOf.map(buildJsonSchema);\n  }\n  if (schema.oneOf) {\n    result.oneOf = schema.oneOf.map(buildJsonSchema);\n  }\n  if (schema.anyOf) {\n    result.anyOf = schema.anyOf.map(buildJsonSchema);\n  }\n\n  if (result.type === undefined && !schema.properties && !schema.items) {\n    result.type = \"string\";\n  }\n\n  return result;\n}\n\nfunction paramToJsonSchemaProp(param: ParsedParam): Record<string, unknown> {\n  const base = buildJsonSchema(param.schema);\n  if (param.description && !base.description) {\n    base.description = param.description;\n  }\n  return base;\n}\n\n// ─── Build the full inputSchema for a tool ────────────────────────────────────\n\ninterface ToolInputSchema {\n  type: \"object\";\n  properties: Record<string, unknown>;\n  required: string[];\n}\n\nfunction buildInputSchema(ep: ParsedEndpoint): ToolInputSchema {\n  const properties: Record<string, unknown> = {};\n  const required: string[] = [];\n\n  // Path params\n  for (const p of ep.pathParams) {\n    properties[p.name] = {\n      ...paramToJsonSchemaProp(p),\n      description:\n        (p.description ? p.description + \" \" : \"\") + `(path parameter)`,\n    };\n    if (p.required) required.push(p.name);\n  }\n\n  // Query params\n  for (const p of ep.queryParams) {\n    properties[p.name] = {\n      ...paramToJsonSchemaProp(p),\n      description:\n        (p.description ? p.description + \" \" : \"\") + `(query parameter)`,\n    };\n    if (p.required) required.push(p.name);\n  }\n\n  // Header params (non-auth)\n  for (const p of ep.headerParams) {\n    properties[p.name] = {\n      ...paramToJsonSchemaProp(p),\n      description:\n        (p.description ? p.description + \" \" : \"\") + `(header parameter)`,\n    };\n    if (p.required) required.push(p.name);\n  }\n\n  // Request body\n  if (ep.hasBody) {\n    if (ep.bodySchema?.properties) {\n      // Flatten top-level body properties into the tool input\n      for (const [key, propSchema] of Object.entries(ep.bodySchema.properties)) {\n        properties[key] = buildJsonSchema(propSchema);\n        if (ep.bodySchema.required?.includes(key)) required.push(key);\n      }\n    } else {\n      // Treat body as opaque \"body\" parameter\n      properties[\"body\"] = ep.bodySchema\n        ? buildJsonSchema(ep.bodySchema)\n        : { type: \"object\", description: \"Request body\" };\n      if (ep.bodyRequired) required.push(\"body\");\n    }\n  }\n\n  return { type: \"object\", properties, required };\n}\n\n// ─── Template data shapes ─────────────────────────────────────────────────────\n\ninterface PathReplacement {\n  /** The literal OpenAPI placeholder, e.g. \"{petId}\" */\n  placeholder: string;\n  /** The JS arg name, e.g. \"petId\" */\n  paramName: string;\n}\n\ninterface ToolData {\n  toolName: string;\n  description: string;\n  inputSchemaJson: string;\n  method: string;\n  urlPath: string;\n  pathParams: string[];           // param names\n  pathReplacements: PathReplacement[];\n  queryParams: string[];          // param names\n  headerParams: string[];         // param names\n  hasBody: boolean;\n  bodyHasTopLevelProps: boolean;\n  bodyProps: string[];            // top-level body prop names (when flattened)\n  bodyContentType: string;\n  deprecated: boolean;\n}\n\nfunction buildToolData(ep: ParsedEndpoint): ToolData {\n  const inputSchema = buildInputSchema(ep);\n  const bodyHasTopLevelProps = Boolean(ep.bodySchema?.properties);\n  const bodyProps = bodyHasTopLevelProps\n    ? Object.keys(ep.bodySchema!.properties!)\n    : [];\n\n  return {\n    toolName: ep.toolName,\n    description: [ep.summary, ep.description]\n      .filter(Boolean)\n      .filter((v, i, a) => a.indexOf(v) === i) // deduplicate\n      .join(\" — \")\n      .slice(0, 1024) || ep.path,\n    inputSchemaJson: JSON.stringify(inputSchema, null, 4),\n    method: ep.method.toUpperCase(),\n    urlPath: ep.path,\n    pathParams: ep.pathParams.map((p) => p.name),\n    pathReplacements: ep.pathParams.map((p) => ({\n      placeholder: `{${p.name}}`,\n      paramName: p.name,\n    })),\n    queryParams: ep.queryParams.map((p) => p.name),\n    headerParams: ep.headerParams.map((p) => p.name),\n    hasBody: ep.hasBody,\n    bodyHasTopLevelProps,\n    bodyProps,\n    bodyContentType: ep.bodyContentType,\n    deprecated: ep.deprecated,\n  };\n}\n\n// ─── Main generator ───────────────────────────────────────────────────────────\n\nexport interface GenerateOptions {\n  outputDir: string;\n}\n\nexport async function generate(\n  spec: ParsedSpec,\n  options: GenerateOptions\n): Promise<void> {\n  const { outputDir } = options;\n\n  await fs.ensureDir(outputDir);\n  await fs.ensureDir(path.join(outputDir, \"src\"));\n\n  const tools = spec.endpoints.map(buildToolData);\n\n  const serverName = spec.title\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\") || \"openapi-mcp\";\n\n  const templateData = {\n    serverName,\n    serverTitle: spec.title,\n    serverVersion: spec.info ? spec.version : \"1.0.0\",\n    serverDescription: spec.description || spec.title,\n    baseUrl: spec.baseUrl,\n    tools,\n    toolCount: tools.length,\n    auth: spec.auth,\n    hasAuth: spec.auth.type !== \"none\",\n    isBearer: spec.auth.type === \"bearer\",\n    isApiKey: spec.auth.type === \"apiKey\",\n    isBasic: spec.auth.type === \"basic\",\n    apiKeyInHeader: spec.auth.paramIn === \"header\",\n    apiKeyInQuery: spec.auth.paramIn === \"query\",\n  };\n\n  // Generate src/server.ts\n  const serverCode = renderTemplate(\"server.ts.hbs\", templateData);\n  await fs.writeFile(path.join(outputDir, \"src\", \"server.ts\"), serverCode, \"utf-8\");\n\n  // Generate package.json\n  const pkgJson = renderTemplate(\"package.json.hbs\", templateData);\n  await fs.writeFile(path.join(outputDir, \"package.json\"), pkgJson, \"utf-8\");\n\n  // Generate tsconfig.json\n  const tsconfigContent = JSON.stringify(\n    {\n      compilerOptions: {\n        target: \"ES2022\",\n        module: \"ESNext\",\n        moduleResolution: \"bundler\",\n        strict: true,\n        esModuleInterop: true,\n        skipLibCheck: true,\n        outDir: \"dist\",\n        rootDir: \"src\",\n        resolveJsonModule: true,\n      },\n      include: [\"src\"],\n      exclude: [\"node_modules\", \"dist\"],\n    },\n    null,\n    2\n  );\n  await fs.writeFile(\n    path.join(outputDir, \"tsconfig.json\"),\n    tsconfigContent,\n    \"utf-8\"\n  );\n\n  // Generate .env.example\n  const envLines: string[] = [\"# Generated by openapi-to-mcp\", \"\"];\n  if (spec.auth.type !== \"none\") {\n    envLines.push(`# ${spec.auth.description}`);\n    envLines.push(`${spec.auth.envVar}=`);\n    envLines.push(\"\");\n  }\n  envLines.push(\"# Override the base URL if needed\");\n  envLines.push(`BASE_URL=${spec.baseUrl}`);\n  envLines.push(\"\");\n  await fs.writeFile(\n    path.join(outputDir, \".env.example\"),\n    envLines.join(\"\\n\"),\n    \"utf-8\"\n  );\n\n  // Generate README.md for the generated server\n  const readme = buildGeneratedReadme(spec, serverName, tools.length);\n  await fs.writeFile(path.join(outputDir, \"README.md\"), readme, \"utf-8\");\n}\n\nfunction buildGeneratedReadme(\n  spec: ParsedSpec,\n  serverName: string,\n  toolCount: number\n): string {\n  const authSection =\n    spec.auth.type === \"none\"\n      ? \"\"\n      : `## Authentication\n\nSet the \\`${spec.auth.envVar}\\` environment variable:\n\n\\`\\`\\`bash\nexport ${spec.auth.envVar}=your_token_here\n\\`\\`\\`\n\n${spec.auth.description}\n`;\n\n  return `# ${spec.title} MCP Server\n\nGenerated by [openapi-to-mcp](https://github.com/example/openapi-to-mcp).\n\n**${spec.description || spec.title}**\n\n- **Base URL:** \\`${spec.baseUrl}\\`\n- **Tools:** ${toolCount}\n\n## Quick Start\n\n\\`\\`\\`bash\nnpm install\nnpm run build\nnode dist/server.js\n\\`\\`\\`\n\n${authSection}\n## Usage with Claude Desktop\n\nAdd to your \\`claude_desktop_config.json\\`:\n\n\\`\\`\\`json\n{\n  \"mcpServers\": {\n    \"${serverName}\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/${serverName}/dist/server.js\"]${spec.auth.type !== \"none\" ? `,\n      \"env\": {\n        \"${spec.auth.envVar}\": \"your_token_here\"\n      }` : \"\"}\n    }\n  }\n}\n\\`\\`\\`\n\n## Available Tools (${toolCount})\n\n| Tool | Method | Path | Description |\n|------|--------|------|-------------|\n${spec.endpoints\n  .map(\n    (ep) =>\n      `| \\`${ep.toolName}\\` | \\`${ep.method.toUpperCase()}\\` | \\`${ep.path}\\` | ${ep.summary || ep.description || \"\"} |`\n  )\n  .join(\"\\n\")}\n`;\n}\n","import Handlebars from \"handlebars\";\nimport fs from \"fs-extra\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nHandlebars.registerHelper(\"eq\", (a: unknown, b: unknown) => a === b);\nHandlebars.registerHelper(\"neq\", (a: unknown, b: unknown) => a !== b);\nHandlebars.registerHelper(\"and\", (a: unknown, b: unknown) => Boolean(a) && Boolean(b));\nHandlebars.registerHelper(\"or\", (a: unknown, b: unknown) => Boolean(a) || Boolean(b));\nHandlebars.registerHelper(\"not\", (a: unknown) => !a);\nHandlebars.registerHelper(\"gt\", (a: number, b: number) => a > b);\n\n/** JSON-stringify a value for embedding in a template */\nHandlebars.registerHelper(\"json\", (value: unknown) =>\n  JSON.stringify(value, null, 2)\n);\n\n/** JSON-stringify inline (no pretty-print) */\nHandlebars.registerHelper(\"jsonInline\", (value: unknown) =>\n  JSON.stringify(value)\n);\n\n/** Upper-case first letter */\nHandlebars.registerHelper(\"ucFirst\", (s: string) =>\n  s ? s.charAt(0).toUpperCase() + s.slice(1) : \"\"\n);\n\n// ─── Template resolution ──────────────────────────────────────────────────────\n\nfunction getTemplatesRoot(): string {\n  const candidates = [\n    path.resolve(__dirname, \"..\", \"templates\"),\n    path.resolve(__dirname, \"..\", \"..\", \"templates\"),\n  ];\n  for (const candidate of candidates) {\n    if (fs.existsSync(candidate)) return candidate;\n  }\n  throw new Error(\n    \"Templates directory not found. Searched: \" + candidates.join(\", \")\n  );\n}\n\nexport function renderTemplate(\n  templateFile: string,\n  data: Record<string, unknown>\n): string {\n  const templatesRoot = getTemplatesRoot();\n  const templatePath = path.join(templatesRoot, templateFile);\n\n  if (!fs.existsSync(templatePath)) {\n    throw new Error(`Template file not found: ${templatePath}`);\n  }\n\n  const raw = fs.readFileSync(templatePath, \"utf-8\");\n  const compiled = Handlebars.compile(raw, { noEscape: true });\n  return compiled(data);\n}\n"],"mappings":"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","names":["path","path","fs","fs","path","fs","path","path"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "openapi-mcp-gen",
+  "version": "1.0.0",
+  "description": "Generate a fully working MCP server from an OpenAPI 3.x spec",
+  "type": "module",
+  "bin": {
+    "openapi-to-mcp": "./dist/index.js",
+    "mcp-from-openapi": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "openapi",
+    "swagger",
+    "codegen",
+    "cli",
+    "generator",
+    "ai",
+    "llm"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "handlebars": "^4.7.8",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.14.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0"
+  }
+}

package/templates/package.json.hbs

@@ -0,0 +1,26 @@
+{
+  "name": "{{{serverName}}}",
+  "version": "1.0.0",
+  "description": "MCP server for {{{serverTitle}}} — generated by openapi-to-mcp",
+  "type": "module",
+  "main": "./dist/server.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "node --watch dist/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "{{{serverName}}}"
+  ],
+  "license": "MIT"
+}

package/templates/server.ts.hbs

@@ -0,0 +1,212 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// ─── Configuration ────────────────────────────────────────────────────────────
+
+const BASE_URL = process.env.BASE_URL?.replace(/\/$/, "") ?? "{{{baseUrl}}}";
+{{#if hasAuth}}
+
+{{#if isBearer}}
+const BEARER_TOKEN = process.env.{{auth.envVar}};
+if (!BEARER_TOKEN) {
+  console.error("Error: {{auth.envVar}} environment variable is required.");
+  console.error("Set it to your Bearer token before starting the server.");
+  process.exit(1);
+}
+{{/if}}
+{{#if isApiKey}}
+const API_KEY = process.env.{{auth.envVar}};
+if (!API_KEY) {
+  console.error("Error: {{auth.envVar}} environment variable is required.");
+  console.error("Set it to your API key before starting the server.");
+  process.exit(1);
+}
+{{/if}}
+{{#if isBasic}}
+const BASIC_CREDENTIALS = process.env.{{auth.envVar}};
+if (!BASIC_CREDENTIALS) {
+  console.error("Error: {{auth.envVar}} environment variable is required.");
+  console.error("Set it to base64-encoded 'username:password' before starting the server.");
+  process.exit(1);
+}
+{{/if}}
+{{/if}}
+
+// ─── HTTP client helpers ──────────────────────────────────────────────────────
+
+function buildAuthHeaders(): Record<string, string> {
+{{#if isBearer}}
+  return { Authorization: `Bearer ${BEARER_TOKEN}` };
+{{else if isBasic}}
+  return { Authorization: `Basic ${BASIC_CREDENTIALS}` };
+{{else}}
+  return {};
+{{/if}}
+}
+
+{{#if isApiKey}}
+{{#if apiKeyInQuery}}
+function buildAuthQuery(): Record<string, string> {
+  return { {{{auth.paramName}}}: API_KEY! };
+}
+{{/if}}
+{{/if}}
+
+interface FetchOptions {
+  method: string;
+  headers?: Record<string, string>;
+  body?: string;
+}
+
+async function apiFetch(
+  urlPath: string,
+  options: FetchOptions
+): Promise<{ ok: boolean; status: number; data: unknown }> {
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    ...buildAuthHeaders(),
+    ...(options.headers ?? {}),
+  };
+{{#if isApiKey}}
+{{#if apiKeyInHeader}}
+  headers["{{{auth.paramName}}}"] = API_KEY!;
+{{/if}}
+{{/if}}
+
+  const url = new URL(BASE_URL + urlPath);
+{{#if isApiKey}}
+{{#if apiKeyInQuery}}
+  const authQuery = buildAuthQuery();
+  for (const [k, v] of Object.entries(authQuery)) url.searchParams.set(k, v);
+{{/if}}
+{{/if}}
+
+  const res = await fetch(url.toString(), {
+    method: options.method,
+    headers,
+    body: options.body,
+  });
+
+  let data: unknown;
+  const contentType = res.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    data = await res.json();
+  } else {
+    data = await res.text();
+  }
+
+  return { ok: res.ok, status: res.status, data };
+}
+
+// ─── Server setup ─────────────────────────────────────────────────────────────
+
+const server = new McpServer({
+  name: "{{{serverName}}}",
+  version: "{{{serverVersion}}}",
+});
+
+// ─── Tools ────────────────────────────────────────────────────────────────────
+{{#each tools}}
+
+{{#if deprecated}}
+// ⚠ DEPRECATED
+{{/if}}
+// {{method}} {{urlPath}}
+server.tool(
+  "{{{toolName}}}",
+  "{{{description}}}",
+  {{{inputSchemaJson}}},
+  async (args) => {
+    // Build URL with path parameters
+    let urlPath = "{{{urlPath}}}";
+    {{#each pathParams}}
+    urlPath = urlPath.replace("{{{{}}}}{{{this}}}{{{{}}}}", encodeURIComponent(String(args.{{{this}}})));
+    {{/each}}
+
+    // Build query string
+    const query = new URLSearchParams();
+    {{#each queryParams}}
+    if (args.{{{this}}} !== undefined && args.{{{this}}} !== null) {
+      query.set("{{{this}}}", String(args.{{{this}}}));
+    }
+    {{/each}}
+    const queryString = query.toString();
+    if (queryString) urlPath += "?" + queryString;
+
+    // Build extra headers
+    const extraHeaders: Record<string, string> = {};
+    {{#each headerParams}}
+    if (args.{{{this}}} !== undefined) {
+      extraHeaders["{{{this}}}"] = String(args.{{{this}}});
+    }
+    {{/each}}
+
+    {{#if hasBody}}
+    // Build request body
+    {{#if bodyHasTopLevelProps}}
+    const bodyObj: Record<string, unknown> = {};
+    {{#each bodyProps}}
+    if (args.{{{this}}} !== undefined) bodyObj["{{{this}}}"] = args.{{{this}}};
+    {{/each}}
+    const bodyStr = JSON.stringify(bodyObj);
+    {{else}}
+    const bodyStr = args.body !== undefined ? JSON.stringify(args.body) : undefined;
+    {{/if}}
+    {{/if}}
+
+    try {
+      const result = await apiFetch(urlPath, {
+        method: "{{{method}}}",
+        headers: Object.keys(extraHeaders).length > 0 ? extraHeaders : undefined,
+        {{#if hasBody}}
+        body: bodyStr,
+        {{/if}}
+      });
+
+      if (!result.ok) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `API error ${result.status}: ${JSON.stringify(result.data, null, 2)}`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: typeof result.data === "string"
+              ? result.data
+              : JSON.stringify(result.data, null, 2),
+          },
+        ],
+      };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return {
+        content: [{ type: "text", text: `Request failed: ${message}` }],
+        isError: true,
+      };
+    }
+  }
+);
+{{/each}}
+
+// ─── Start ────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("{{{serverTitle}}} MCP server running on stdio");
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});