mcp-use 2.0.0-beta.0 → 2.0.0-beta.1

package/dist/chunk-AATFAERC.js

@@ -0,0 +1,384 @@
+// src/openapi/index.ts
+import {
+  fromJsonSchema
+} from "@modelcontextprotocol/server";
+var HTTP_METHODS = [
+  "get",
+  "put",
+  "post",
+  "delete",
+  "options",
+  "head",
+  "patch",
+  "trace"
+];
+function registerOpenAPITools(server, options) {
+  const operations = collectOperations(options.spec, options);
+  const names = createToolNames(operations);
+  const baseUrl = operations.length > 0 ? resolveBaseUrl(options) : void 0;
+  for (const [index, operation] of operations.entries()) {
+    const name = names[index];
+    if (name === void 0 || baseUrl === void 0) continue;
+    const inputBindings = createInputBindings(operation);
+    server.tool(
+      {
+        name,
+        description: createToolDescription(operation),
+        inputSchema: createToolInputSchema(
+          options.spec,
+          operation,
+          inputBindings
+        )
+      },
+      async (params) => callOpenAPIOperation(operation, params, options, inputBindings, baseUrl)
+    );
+  }
+}
+function collectOperations(spec, options) {
+  const collected = [];
+  for (const [path, pathItemOrRef] of Object.entries(spec.paths ?? {})) {
+    const pathItem = resolveRef(spec, pathItemOrRef);
+    if (pathItem === void 0 || isReferenceObject(pathItem)) continue;
+    const pathParameters = resolveParameters(spec, pathItem.parameters);
+    for (const method of HTTP_METHODS) {
+      const operationOrRef = pathItem[method];
+      if (operationOrRef === void 0) continue;
+      const operation = resolveRef(
+        spec,
+        operationOrRef
+      );
+      if (operation === void 0 || isReferenceObject(operation)) continue;
+      const operationParameters = resolveParameters(spec, operation.parameters);
+      const requestBody = operation.requestBody === void 0 ? void 0 : resolveRef(spec, operation.requestBody);
+      const item = {
+        method,
+        path,
+        operation,
+        parameters: mergeParameters(pathParameters, operationParameters),
+        ...requestBody !== void 0 && !isReferenceObject(requestBody) && { requestBody }
+      };
+      if (isIncluded(item, options)) collected.push(item);
+    }
+  }
+  return collected;
+}
+function resolveParameters(spec, parameters) {
+  const resolved = [];
+  for (const parameter of parameters ?? []) {
+    const value = resolveRef(spec, parameter);
+    if (value !== void 0 && !isReferenceObject(value)) resolved.push(value);
+  }
+  return resolved;
+}
+function mergeParameters(pathParameters, operationParameters) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const parameter of [...pathParameters, ...operationParameters]) {
+    merged.set(`${parameter.in}:${parameter.name}`, parameter);
+  }
+  return [...merged.values()];
+}
+function isIncluded(operation, options) {
+  if (options.tags?.length) {
+    const tags = new Set(operation.operation.tags ?? []);
+    if (!options.tags.some((tag) => tags.has(tag))) return false;
+  }
+  return !(options.exclude ?? []).some(
+    (rule) => matchesExcludeRule(operation, rule)
+  );
+}
+function matchesExcludeRule(operation, rule) {
+  if (rule.method && rule.method.toLowerCase() !== operation.method) {
+    return false;
+  }
+  if (rule.operationId && !matchesPattern(rule.operationId, operation.operation.operationId ?? "")) {
+    return false;
+  }
+  if (rule.path && !matchesPattern(rule.path, operation.path)) return false;
+  if (rule.tags?.length) {
+    const tags = new Set(operation.operation.tags ?? []);
+    if (!rule.tags.some((tag) => tags.has(tag))) return false;
+  }
+  return true;
+}
+function matchesPattern(pattern, value) {
+  if (typeof pattern === "string") return pattern === value;
+  pattern.lastIndex = 0;
+  return pattern.test(value);
+}
+function createToolNames(operations) {
+  const seen = /* @__PURE__ */ new Map();
+  return operations.map((operation) => {
+    const baseName = slugifyToolName(
+      operation.operation.operationId ?? `${operation.method}_${operation.path.replace(/[{}]/g, "").replace(/\//g, "_")}`
+    );
+    const count = seen.get(baseName) ?? 0;
+    seen.set(baseName, count + 1);
+    if (count === 0) return baseName;
+    const suffix = `_${count + 1}`;
+    return `${baseName.slice(0, 64 - suffix.length)}${suffix}`;
+  });
+}
+function createToolDescription(operation) {
+  return [
+    operation.operation.summary,
+    operation.operation.description,
+    `HTTP: ${operation.method.toUpperCase()} ${operation.path}`
+  ].filter((part) => Boolean(part)).join("\n\n");
+}
+function slugifyToolName(value) {
+  const slug = value.trim().replace(/[^a-zA-Z0-9_-]+/g, "_").replace(/_+/g, "_").replace(/^_/, "").replace(/_$/, "").slice(0, 64);
+  return slug || "openapi_tool";
+}
+function createToolInputSchema(spec, operation, inputBindings) {
+  const properties = {};
+  const required = [];
+  for (const { parameter, inputName } of inputBindings.parameters) {
+    const parameterSchema = transformSchema(
+      spec,
+      parameter.schema ?? {}
+    );
+    properties[inputName] = {
+      ...parameterSchema,
+      description: parameter.description ?? `${parameter.in} parameter`
+    };
+    if (parameter.required || parameter.in === "path") {
+      required.push(inputName);
+    }
+  }
+  const bodySchema = getJsonRequestBodySchema(operation.requestBody);
+  if (bodySchema !== void 0 && inputBindings.bodyInputName !== void 0) {
+    properties[inputBindings.bodyInputName] = transformSchema(spec, bodySchema);
+    if (operation.requestBody?.required) {
+      required.push(inputBindings.bodyInputName);
+    }
+  }
+  const definitions = createSchemaDefinitions(spec);
+  const schema = {
+    type: "object",
+    properties,
+    additionalProperties: false,
+    ...required.length > 0 && { required },
+    ...definitions !== void 0 && { $defs: definitions }
+  };
+  return fromJsonSchema(schema);
+}
+function createInputBindings(operation) {
+  const parameters = operation.parameters.filter(
+    (parameter) => parameter.in !== "cookie"
+  );
+  const bodyInputName = getJsonRequestBodySchema(operation.requestBody) === void 0 ? void 0 : "body";
+  const nameCounts = /* @__PURE__ */ new Map();
+  for (const parameter of parameters) {
+    nameCounts.set(parameter.name, (nameCounts.get(parameter.name) ?? 0) + 1);
+  }
+  const usedNames = new Set(bodyInputName === void 0 ? [] : [bodyInputName]);
+  const bindings = parameters.map((parameter) => {
+    const needsLocation = (nameCounts.get(parameter.name) ?? 0) > 1 || parameter.name === bodyInputName;
+    const preferredName = needsLocation ? `${parameter.name}_${parameter.in}` : parameter.name;
+    return {
+      parameter,
+      inputName: claimInputName(preferredName, usedNames)
+    };
+  });
+  return {
+    parameters: bindings,
+    ...bodyInputName !== void 0 && { bodyInputName }
+  };
+}
+function claimInputName(preferredName, usedNames) {
+  let inputName = preferredName;
+  let suffix = 2;
+  while (usedNames.has(inputName)) {
+    inputName = `${preferredName}_${suffix}`;
+    suffix += 1;
+  }
+  usedNames.add(inputName);
+  return inputName;
+}
+function createSchemaDefinitions(spec) {
+  const schemas = readRecord(spec.components?.["schemas"]);
+  if (schemas === void 0) return void 0;
+  const definitions = {};
+  for (const [name, schema] of Object.entries(schemas)) {
+    definitions[name] = transformSchemaNode(spec, schema, /* @__PURE__ */ new Set());
+  }
+  return definitions;
+}
+function transformSchema(spec, schema) {
+  const transformed = transformSchemaNode(spec, schema, /* @__PURE__ */ new Set());
+  return readRecord(transformed) ?? {};
+}
+function transformSchemaNode(spec, value, resolvingRefs) {
+  if (Array.isArray(value)) {
+    return value.map((item) => transformSchemaNode(spec, item, resolvingRefs));
+  }
+  const object = readRecord(value);
+  if (object === void 0) return value;
+  const ref = typeof object["$ref"] === "string" ? object["$ref"] : void 0;
+  const siblings = {};
+  for (const [key, child] of Object.entries(object)) {
+    if (key === "$ref") continue;
+    if (key === "nullable" && typeof child === "boolean") continue;
+    siblings[key] = transformSchemaNode(spec, child, resolvingRefs);
+  }
+  let transformed = siblings;
+  if (ref !== void 0) {
+    const schemaRef = rewriteSchemaRef(spec, ref);
+    if (schemaRef !== void 0) {
+      transformed = { $ref: schemaRef, ...siblings };
+    } else if (!resolvingRefs.has(ref)) {
+      const resolved = resolveRef(spec, { $ref: ref });
+      if (resolved !== void 0) {
+        const nextRefs = new Set(resolvingRefs);
+        nextRefs.add(ref);
+        transformed = {
+          ...readRecord(transformSchemaNode(spec, resolved, nextRefs)) ?? {},
+          ...siblings
+        };
+      }
+    }
+  }
+  if (object["nullable"] === true) {
+    return { anyOf: [transformed, { type: "null" }] };
+  }
+  return transformed;
+}
+function rewriteSchemaRef(spec, ref) {
+  const prefix = "#/components/schemas/";
+  if (!ref.startsWith(prefix)) return void 0;
+  return resolveRef(spec, { $ref: ref }) === void 0 ? void 0 : `#/$defs/${ref.slice(prefix.length)}`;
+}
+function getJsonRequestBodySchema(requestBody) {
+  const content = requestBody?.content;
+  if (content === void 0) return void 0;
+  return content["application/json"]?.schema ?? content["application/*+json"]?.schema ?? Object.entries(content).find(
+    ([mediaType]) => mediaType.includes("+json")
+  )?.[1].schema;
+}
+async function callOpenAPIOperation(operation, params, options, inputBindings, baseUrl) {
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const url = buildUrl(operation, params, inputBindings.parameters, baseUrl);
+  const headers = buildHeaders(inputBindings.parameters, params, options);
+  const bodyInputName = inputBindings.bodyInputName;
+  const body = bodyInputName === void 0 || params[bodyInputName] === void 0 ? void 0 : JSON.stringify(params[bodyInputName]);
+  if (body !== void 0 && !hasHeader(headers, "content-type")) {
+    headers["content-type"] = "application/json";
+  }
+  const response = await fetchImpl(url, {
+    method: operation.method.toUpperCase(),
+    headers,
+    ...body !== void 0 && { body }
+  });
+  const contentType = response.headers.get("content-type") ?? "";
+  if (!response.ok) {
+    return {
+      content: [{ type: "text", text: await response.text() }],
+      isError: true
+    };
+  }
+  if (contentType.includes("application/json") || contentType.includes("+json")) {
+    const text = await response.text();
+    try {
+      const data = JSON.parse(text);
+      return {
+        content: [{ type: "text", text: JSON.stringify(data) }],
+        structuredContent: data
+      };
+    } catch {
+      return { content: [{ type: "text", text }] };
+    }
+  }
+  return { content: [{ type: "text", text: await response.text() }] };
+}
+function buildUrl(operation, params, parameterBindings, baseUrl) {
+  const interpolatedPath = operation.path.replace(
+    /{([^}]+)}/g,
+    (_match, name) => {
+      const binding = parameterBindings.find(
+        ({ parameter }) => parameter.in === "path" && parameter.name === name
+      );
+      return encodeURIComponent(
+        String(binding === void 0 ? "" : params[binding.inputName] ?? "")
+      );
+    }
+  );
+  const url = new URL(
+    interpolatedPath.replace(/^\/+/, ""),
+    ensureTrailingSlash(baseUrl)
+  );
+  for (const { parameter, inputName } of parameterBindings) {
+    if (parameter.in !== "query") continue;
+    const value = params[inputName];
+    if (value === void 0 || value === null || value === "") continue;
+    appendQueryParam(url, parameter.name, value);
+  }
+  return url.toString();
+}
+function buildHeaders(parameterBindings, params, options) {
+  const headers = { ...options.headers ?? {} };
+  for (const { parameter, inputName } of parameterBindings) {
+    if (parameter.in !== "header") continue;
+    const value = params[inputName];
+    if (value === void 0 || value === null || value === "") continue;
+    headers[parameter.name] = String(value);
+  }
+  if (options.auth?.type === "bearer" && options.auth.token) {
+    headers["authorization"] = `Bearer ${options.auth.token}`;
+  }
+  if (options.auth?.type === "header" && options.auth.value) {
+    headers[options.auth.name] = options.auth.value;
+  }
+  return headers;
+}
+function resolveBaseUrl(options) {
+  const baseUrl = options.baseUrl ?? options.spec.servers?.[0]?.url;
+  if (baseUrl === void 0 || baseUrl.trim() === "") {
+    throw new Error(
+      "MCPServer.fromOpenAPI requires options.baseUrl or spec.servers[0].url"
+    );
+  }
+  return baseUrl;
+}
+function appendQueryParam(url, name, value) {
+  if (Array.isArray(value)) {
+    for (const item of value) {
+      if (item !== void 0 && item !== null && item !== "") {
+        url.searchParams.append(name, String(item));
+      }
+    }
+    return;
+  }
+  url.searchParams.set(name, String(value));
+}
+function ensureTrailingSlash(url) {
+  return url.endsWith("/") ? url : `${url}/`;
+}
+function hasHeader(headers, name) {
+  return Object.keys(headers).some(
+    (headerName) => headerName.toLowerCase() === name
+  );
+}
+function isReferenceObject(value) {
+  const object = readRecord(value);
+  return object !== void 0 && typeof object["$ref"] === "string";
+}
+function resolveRef(spec, value) {
+  if (!isReferenceObject(value)) return value;
+  if (!value.$ref.startsWith("#/")) return void 0;
+  const segments = value.$ref.slice(2).split("/").map((segment) => segment.replace(/~1/g, "/").replace(/~0/g, "~"));
+  let current = spec;
+  for (const segment of segments) {
+    const object = readRecord(current);
+    if (object === void 0 || !(segment in object)) return void 0;
+    current = object[segment];
+  }
+  return current;
+}
+function readRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+
+export {
+  registerOpenAPITools
+};
+//# sourceMappingURL=chunk-AATFAERC.js.map

package/dist/chunk-AATFAERC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/openapi/index.ts"],"sourcesContent":["import {\n  fromJsonSchema,\n  type CallToolResult,\n  type JSONValue,\n  type JsonSchemaType,\n  type StandardSchemaWithJSON,\n} from \"@modelcontextprotocol/server\";\n\nimport type { MCPServer } from \"../server.js\";\nimport type {\n  CollectedOpenAPIOperation,\n  FromOpenAPIOptions,\n  OpenAPIDocument,\n  OpenAPIExcludeRule,\n  OpenAPIHttpMethod,\n  OpenAPIOperationObject,\n  OpenAPIParameterObject,\n  OpenAPIPathItemObject,\n  OpenAPIReferenceObject,\n  OpenAPIRequestBodyObject,\n  OpenAPISchemaObject,\n} from \"./types.js\";\n\nexport type {\n  FromOpenAPIOptions,\n  OpenAPIAuth,\n  OpenAPIDocument,\n  OpenAPIExcludeRule,\n} from \"./types.js\";\n\nconst HTTP_METHODS: OpenAPIHttpMethod[] = [\n  \"get\",\n  \"put\",\n  \"post\",\n  \"delete\",\n  \"options\",\n  \"head\",\n  \"patch\",\n  \"trace\",\n];\n\n/**\n * Register every included operation in a bundled OpenAPI document as an MCP\n * tool on an existing server.\n *\n * @internal\n */\nexport function registerOpenAPITools(\n  server: Pick<MCPServer, \"tool\">,\n  options: FromOpenAPIOptions\n): void {\n  const operations = collectOperations(options.spec, options);\n  const names = createToolNames(operations);\n  const baseUrl = operations.length > 0 ? resolveBaseUrl(options) : undefined;\n\n  for (const [index, operation] of operations.entries()) {\n    const name = names[index];\n    if (name === undefined || baseUrl === undefined) continue;\n    const inputBindings = createInputBindings(operation);\n\n    server.tool(\n      {\n        name,\n        description: createToolDescription(operation),\n        inputSchema: createToolInputSchema(\n          options.spec,\n          operation,\n          inputBindings\n        ),\n      },\n      async (params) =>\n        callOpenAPIOperation(operation, params, options, inputBindings, baseUrl)\n    );\n  }\n}\n\ninterface OpenAPIParameterBinding {\n  parameter: OpenAPIParameterObject;\n  inputName: string;\n}\n\ninterface OpenAPIInputBindings {\n  parameters: OpenAPIParameterBinding[];\n  bodyInputName?: string;\n}\n\nfunction collectOperations(\n  spec: OpenAPIDocument,\n  options: Pick<FromOpenAPIOptions, \"tags\" | \"exclude\">\n): CollectedOpenAPIOperation[] {\n  const collected: CollectedOpenAPIOperation[] = [];\n\n  for (const [path, pathItemOrRef] of Object.entries(spec.paths ?? {})) {\n    const pathItem = resolveRef<OpenAPIPathItemObject>(spec, pathItemOrRef);\n    if (pathItem === undefined || isReferenceObject(pathItem)) continue;\n\n    const pathParameters = resolveParameters(spec, pathItem.parameters);\n\n    for (const method of HTTP_METHODS) {\n      const operationOrRef = pathItem[method];\n      if (operationOrRef === undefined) continue;\n\n      const operation = resolveRef<OpenAPIOperationObject>(\n        spec,\n        operationOrRef\n      );\n      if (operation === undefined || isReferenceObject(operation)) continue;\n\n      const operationParameters = resolveParameters(spec, operation.parameters);\n      const requestBody =\n        operation.requestBody === undefined\n          ? undefined\n          : resolveRef<OpenAPIRequestBodyObject>(spec, operation.requestBody);\n\n      const item: CollectedOpenAPIOperation = {\n        method,\n        path,\n        operation,\n        parameters: mergeParameters(pathParameters, operationParameters),\n        ...(requestBody !== undefined &&\n          !isReferenceObject(requestBody) && { requestBody }),\n      };\n\n      if (isIncluded(item, options)) collected.push(item);\n    }\n  }\n\n  return collected;\n}\n\nfunction resolveParameters(\n  spec: OpenAPIDocument,\n  parameters?: Array<OpenAPIParameterObject | OpenAPIReferenceObject>\n): OpenAPIParameterObject[] {\n  const resolved: OpenAPIParameterObject[] = [];\n  for (const parameter of parameters ?? []) {\n    const value = resolveRef<OpenAPIParameterObject>(spec, parameter);\n    if (value !== undefined && !isReferenceObject(value)) resolved.push(value);\n  }\n  return resolved;\n}\n\nfunction mergeParameters(\n  pathParameters: OpenAPIParameterObject[],\n  operationParameters: OpenAPIParameterObject[]\n): OpenAPIParameterObject[] {\n  const merged = new Map<string, OpenAPIParameterObject>();\n  for (const parameter of [...pathParameters, ...operationParameters]) {\n    merged.set(`${parameter.in}:${parameter.name}`, parameter);\n  }\n  return [...merged.values()];\n}\n\nfunction isIncluded(\n  operation: CollectedOpenAPIOperation,\n  options: Pick<FromOpenAPIOptions, \"tags\" | \"exclude\">\n): boolean {\n  if (options.tags?.length) {\n    const tags = new Set(operation.operation.tags ?? []);\n    if (!options.tags.some((tag) => tags.has(tag))) return false;\n  }\n\n  return !(options.exclude ?? []).some((rule) =>\n    matchesExcludeRule(operation, rule)\n  );\n}\n\nfunction matchesExcludeRule(\n  operation: CollectedOpenAPIOperation,\n  rule: OpenAPIExcludeRule\n): boolean {\n  if (rule.method && rule.method.toLowerCase() !== operation.method) {\n    return false;\n  }\n  if (\n    rule.operationId &&\n    !matchesPattern(rule.operationId, operation.operation.operationId ?? \"\")\n  ) {\n    return false;\n  }\n  if (rule.path && !matchesPattern(rule.path, operation.path)) return false;\n  if (rule.tags?.length) {\n    const tags = new Set(operation.operation.tags ?? []);\n    if (!rule.tags.some((tag) => tags.has(tag))) return false;\n  }\n  return true;\n}\n\nfunction matchesPattern(pattern: string | RegExp, value: string): boolean {\n  if (typeof pattern === \"string\") return pattern === value;\n  pattern.lastIndex = 0;\n  return pattern.test(value);\n}\n\nfunction createToolNames(operations: CollectedOpenAPIOperation[]): string[] {\n  const seen = new Map<string, number>();\n  return operations.map((operation) => {\n    const baseName = slugifyToolName(\n      operation.operation.operationId ??\n        `${operation.method}_${operation.path\n          .replace(/[{}]/g, \"\")\n          .replace(/\\//g, \"_\")}`\n    );\n    const count = seen.get(baseName) ?? 0;\n    seen.set(baseName, count + 1);\n    if (count === 0) return baseName;\n\n    const suffix = `_${count + 1}`;\n    return `${baseName.slice(0, 64 - suffix.length)}${suffix}`;\n  });\n}\n\nfunction createToolDescription(operation: CollectedOpenAPIOperation): string {\n  return [\n    operation.operation.summary,\n    operation.operation.description,\n    `HTTP: ${operation.method.toUpperCase()} ${operation.path}`,\n  ]\n    .filter((part): part is string => Boolean(part))\n    .join(\"\\n\\n\");\n}\n\nfunction slugifyToolName(value: string): string {\n  const slug = value\n    .trim()\n    .replace(/[^a-zA-Z0-9_-]+/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_/, \"\")\n    .replace(/_$/, \"\")\n    .slice(0, 64);\n  return slug || \"openapi_tool\";\n}\n\nfunction createToolInputSchema(\n  spec: OpenAPIDocument,\n  operation: CollectedOpenAPIOperation,\n  inputBindings: OpenAPIInputBindings\n): StandardSchemaWithJSON<Record<string, unknown>, Record<string, unknown>> {\n  const properties: Record<string, unknown> = {};\n  const required: string[] = [];\n\n  for (const { parameter, inputName } of inputBindings.parameters) {\n    const parameterSchema = transformSchema(\n      spec,\n      parameter.schema ?? ({} satisfies OpenAPISchemaObject)\n    );\n    properties[inputName] = {\n      ...parameterSchema,\n      description: parameter.description ?? `${parameter.in} parameter`,\n    };\n    if (parameter.required || parameter.in === \"path\") {\n      required.push(inputName);\n    }\n  }\n\n  const bodySchema = getJsonRequestBodySchema(operation.requestBody);\n  if (bodySchema !== undefined && inputBindings.bodyInputName !== undefined) {\n    properties[inputBindings.bodyInputName] = transformSchema(spec, bodySchema);\n    if (operation.requestBody?.required) {\n      required.push(inputBindings.bodyInputName);\n    }\n  }\n\n  const definitions = createSchemaDefinitions(spec);\n  const schema = {\n    type: \"object\",\n    properties,\n    additionalProperties: false,\n    ...(required.length > 0 && { required }),\n    ...(definitions !== undefined && { $defs: definitions }),\n  };\n\n  return fromJsonSchema<Record<string, unknown>>(schema as JsonSchemaType);\n}\n\nfunction createInputBindings(\n  operation: CollectedOpenAPIOperation\n): OpenAPIInputBindings {\n  const parameters = operation.parameters.filter(\n    (parameter) => parameter.in !== \"cookie\"\n  );\n  const bodyInputName =\n    getJsonRequestBodySchema(operation.requestBody) === undefined\n      ? undefined\n      : \"body\";\n  const nameCounts = new Map<string, number>();\n  for (const parameter of parameters) {\n    nameCounts.set(parameter.name, (nameCounts.get(parameter.name) ?? 0) + 1);\n  }\n\n  const usedNames = new Set(bodyInputName === undefined ? [] : [bodyInputName]);\n  const bindings = parameters.map((parameter) => {\n    const needsLocation =\n      (nameCounts.get(parameter.name) ?? 0) > 1 ||\n      parameter.name === bodyInputName;\n    const preferredName = needsLocation\n      ? `${parameter.name}_${parameter.in}`\n      : parameter.name;\n    return {\n      parameter,\n      inputName: claimInputName(preferredName, usedNames),\n    };\n  });\n\n  return {\n    parameters: bindings,\n    ...(bodyInputName !== undefined && { bodyInputName }),\n  };\n}\n\nfunction claimInputName(preferredName: string, usedNames: Set<string>): string {\n  let inputName = preferredName;\n  let suffix = 2;\n  while (usedNames.has(inputName)) {\n    inputName = `${preferredName}_${suffix}`;\n    suffix += 1;\n  }\n  usedNames.add(inputName);\n  return inputName;\n}\n\nfunction createSchemaDefinitions(\n  spec: OpenAPIDocument\n): Record<string, unknown> | undefined {\n  const schemas = readRecord(spec.components?.[\"schemas\"]);\n  if (schemas === undefined) return undefined;\n\n  const definitions: Record<string, unknown> = {};\n  for (const [name, schema] of Object.entries(schemas)) {\n    definitions[name] = transformSchemaNode(spec, schema, new Set());\n  }\n  return definitions;\n}\n\nfunction transformSchema(\n  spec: OpenAPIDocument,\n  schema: OpenAPISchemaObject | OpenAPIReferenceObject\n): Record<string, unknown> {\n  const transformed = transformSchemaNode(spec, schema, new Set());\n  return readRecord(transformed) ?? {};\n}\n\nfunction transformSchemaNode(\n  spec: OpenAPIDocument,\n  value: unknown,\n  resolvingRefs: Set<string>\n): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => transformSchemaNode(spec, item, resolvingRefs));\n  }\n  const object = readRecord(value);\n  if (object === undefined) return value;\n\n  const ref = typeof object[\"$ref\"] === \"string\" ? object[\"$ref\"] : undefined;\n  const siblings: Record<string, unknown> = {};\n  for (const [key, child] of Object.entries(object)) {\n    if (key === \"$ref\") continue;\n    if (key === \"nullable\" && typeof child === \"boolean\") continue;\n    siblings[key] = transformSchemaNode(spec, child, resolvingRefs);\n  }\n\n  let transformed: Record<string, unknown> = siblings;\n  if (ref !== undefined) {\n    const schemaRef = rewriteSchemaRef(spec, ref);\n    if (schemaRef !== undefined) {\n      transformed = { $ref: schemaRef, ...siblings };\n    } else if (!resolvingRefs.has(ref)) {\n      const resolved = resolveRef<unknown>(spec, { $ref: ref });\n      if (resolved !== undefined) {\n        const nextRefs = new Set(resolvingRefs);\n        nextRefs.add(ref);\n        transformed = {\n          ...(readRecord(transformSchemaNode(spec, resolved, nextRefs)) ?? {}),\n          ...siblings,\n        };\n      }\n    }\n  }\n\n  if (object[\"nullable\"] === true) {\n    return { anyOf: [transformed, { type: \"null\" }] };\n  }\n  return transformed;\n}\n\nfunction rewriteSchemaRef(\n  spec: OpenAPIDocument,\n  ref: string\n): string | undefined {\n  const prefix = \"#/components/schemas/\";\n  if (!ref.startsWith(prefix)) return undefined;\n  return resolveRef<unknown>(spec, { $ref: ref }) === undefined\n    ? undefined\n    : `#/$defs/${ref.slice(prefix.length)}`;\n}\n\nfunction getJsonRequestBodySchema(\n  requestBody: OpenAPIRequestBodyObject | undefined\n): OpenAPISchemaObject | OpenAPIReferenceObject | undefined {\n  const content = requestBody?.content;\n  if (content === undefined) return undefined;\n  return (\n    content[\"application/json\"]?.schema ??\n    content[\"application/*+json\"]?.schema ??\n    Object.entries(content).find(([mediaType]) =>\n      mediaType.includes(\"+json\")\n    )?.[1].schema\n  );\n}\n\nasync function callOpenAPIOperation(\n  operation: CollectedOpenAPIOperation,\n  params: Record<string, unknown>,\n  options: FromOpenAPIOptions,\n  inputBindings: OpenAPIInputBindings,\n  baseUrl: string\n): Promise<CallToolResult> {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n  const url = buildUrl(operation, params, inputBindings.parameters, baseUrl);\n  const headers = buildHeaders(inputBindings.parameters, params, options);\n  const bodyInputName = inputBindings.bodyInputName;\n  const body =\n    bodyInputName === undefined || params[bodyInputName] === undefined\n      ? undefined\n      : JSON.stringify(params[bodyInputName]);\n\n  if (body !== undefined && !hasHeader(headers, \"content-type\")) {\n    headers[\"content-type\"] = \"application/json\";\n  }\n\n  const response = await fetchImpl(url, {\n    method: operation.method.toUpperCase(),\n    headers,\n    ...(body !== undefined && { body }),\n  });\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n  if (!response.ok) {\n    return {\n      content: [{ type: \"text\", text: await response.text() }],\n      isError: true,\n    };\n  }\n  if (\n    contentType.includes(\"application/json\") ||\n    contentType.includes(\"+json\")\n  ) {\n    const text = await response.text();\n    try {\n      const data = JSON.parse(text) as JSONValue;\n      return {\n        content: [{ type: \"text\", text: JSON.stringify(data) }],\n        structuredContent: data,\n      };\n    } catch {\n      return { content: [{ type: \"text\", text }] };\n    }\n  }\n  return { content: [{ type: \"text\", text: await response.text() }] };\n}\n\nfunction buildUrl(\n  operation: CollectedOpenAPIOperation,\n  params: Record<string, unknown>,\n  parameterBindings: OpenAPIParameterBinding[],\n  baseUrl: string\n): string {\n  const interpolatedPath = operation.path.replace(\n    /{([^}]+)}/g,\n    (_match, name: string) => {\n      const binding = parameterBindings.find(\n        ({ parameter }) => parameter.in === \"path\" && parameter.name === name\n      );\n      return encodeURIComponent(\n        String(binding === undefined ? \"\" : (params[binding.inputName] ?? \"\"))\n      );\n    }\n  );\n  const url = new URL(\n    interpolatedPath.replace(/^\\/+/, \"\"),\n    ensureTrailingSlash(baseUrl)\n  );\n\n  for (const { parameter, inputName } of parameterBindings) {\n    if (parameter.in !== \"query\") continue;\n    const value = params[inputName];\n    if (value === undefined || value === null || value === \"\") continue;\n    appendQueryParam(url, parameter.name, value);\n  }\n  return url.toString();\n}\n\nfunction buildHeaders(\n  parameterBindings: OpenAPIParameterBinding[],\n  params: Record<string, unknown>,\n  options: FromOpenAPIOptions\n): Record<string, string> {\n  const headers: Record<string, string> = { ...(options.headers ?? {}) };\n\n  for (const { parameter, inputName } of parameterBindings) {\n    if (parameter.in !== \"header\") continue;\n    const value = params[inputName];\n    if (value === undefined || value === null || value === \"\") continue;\n    headers[parameter.name] = String(value);\n  }\n  if (options.auth?.type === \"bearer\" && options.auth.token) {\n    headers[\"authorization\"] = `Bearer ${options.auth.token}`;\n  }\n  if (options.auth?.type === \"header\" && options.auth.value) {\n    headers[options.auth.name] = options.auth.value;\n  }\n  return headers;\n}\n\nfunction resolveBaseUrl(options: FromOpenAPIOptions): string {\n  const baseUrl = options.baseUrl ?? options.spec.servers?.[0]?.url;\n  if (baseUrl === undefined || baseUrl.trim() === \"\") {\n    throw new Error(\n      \"MCPServer.fromOpenAPI requires options.baseUrl or spec.servers[0].url\"\n    );\n  }\n  return baseUrl;\n}\n\nfunction appendQueryParam(url: URL, name: string, value: unknown): void {\n  if (Array.isArray(value)) {\n    for (const item of value) {\n      if (item !== undefined && item !== null && item !== \"\") {\n        url.searchParams.append(name, String(item));\n      }\n    }\n    return;\n  }\n  url.searchParams.set(name, String(value));\n}\n\nfunction ensureTrailingSlash(url: string): string {\n  return url.endsWith(\"/\") ? url : `${url}/`;\n}\n\nfunction hasHeader(headers: Record<string, string>, name: string): boolean {\n  return Object.keys(headers).some(\n    (headerName) => headerName.toLowerCase() === name\n  );\n}\n\nfunction isReferenceObject(value: unknown): value is OpenAPIReferenceObject {\n  const object = readRecord(value);\n  return object !== undefined && typeof object[\"$ref\"] === \"string\";\n}\n\nfunction resolveRef<T>(\n  spec: OpenAPIDocument,\n  value: T | OpenAPIReferenceObject\n): T | undefined {\n  if (!isReferenceObject(value)) return value;\n  if (!value.$ref.startsWith(\"#/\")) return undefined;\n\n  const segments = value.$ref\n    .slice(2)\n    .split(\"/\")\n    .map((segment) => segment.replace(/~1/g, \"/\").replace(/~0/g, \"~\"));\n  let current: unknown = spec;\n  for (const segment of segments) {\n    const object = readRecord(current);\n    if (object === undefined || !(segment in object)) return undefined;\n    current = object[segment];\n  }\n  return current as T;\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/commands/dev.js

@@ -1,3 +1,6 @@
+import {
+  resolvePort
+} from "../chunk-Q4PUTBMV.js";
 import {
   buildDevViewsManifest,
   discoverEntry,
@@ -8,9 +11,6 @@ import {
   resolveUserViteConfig,
   resolveWorkspacePaths
 } from "../chunk-UDLRVMML.js";
-import {
-  resolvePort
-} from "../chunk-Q4PUTBMV.js";
 
 // src/cli/dev.ts
 import { spawn as spawn2 } from "child_process";

package/dist/index.d.ts

@@ -34,6 +34,7 @@ export type { CompletionCallback, CompletionContext } from "./completable.js";
  */
 export type { StandardSchemaV1, StandardSchemaWithJSON, } from "@modelcontextprotocol/server";
 export type { InspectorOptions, ServerConfig } from "./config.js";
+export type { FromOpenAPIOptions, OpenAPIAuth, OpenAPIDocument, OpenAPIExcludeRule, } from "./openapi/index.js";
 export type { Elicit, ElicitationResult, OAuthAuth, RequestClientContext, RequestContext, } from "./context.js";
 export type { InferToolInput, InferToolName, InferToolOutput, ToolCallback, ToolDefinition, ToolRef, ToolResult, ToolViewConfig, } from "./tools.js";
 export type { ExternalViewManifestEntry, InlineViewManifestEntry, UiPermissions, ViewManifestEntry, ViewsManifest, } from "./views/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,0BAA0B,EAC1B,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;GAKG;AACH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;;;GAKG;AACH,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,0BAA0B,EAC1B,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;GAKG;AACH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;;;GAKG;AACH,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -19,6 +19,9 @@ import {
   resolveLocalOAuthResource,
   wrapOAuthTokenVerifier
 } from "./chunk-DPL7OEXC.js";
+import {
+  registerOpenAPITools
+} from "./chunk-AATFAERC.js";
 
 // src/server.ts
 import {
@@ -929,7 +932,7 @@ function viewResourceConfig(_viewName, _entry, authorFacts, servingOrigin, optio
 }
 
 // src/server.ts
-var MCPServer = class {
+var MCPServer = class _MCPServer {
   #config;
   #tools = /* @__PURE__ */ new Map();
   #resources = /* @__PURE__ */ new Map();
@@ -955,6 +958,34 @@ var MCPServer = class {
   #oauthResourceConfigurationAbsent = false;
   /** Whether the mounted app validates Host headers (fixed at first mount). */
   #hostValidated = false;
+  /**
+   * Create an MCP server from a parsed, bundled OpenAPI document.
+   *
+   * Each included OpenAPI operation becomes a tool that validates its input,
+   * calls the matching upstream HTTP endpoint, and returns the response using
+   * the SDK's raw tool-result shape. External `$ref` values are not fetched;
+   * bundle the document before passing it in.
+   *
+   * @param options - OpenAPI document, operation filters, upstream URL, and
+   * request authentication options.
+   * @returns An unauthenticated MCP server populated with generated tools.
+   *
+   * @example
+   * ```ts
+   * const spec = await fetch("https://api.example.com/openapi.json")
+   *   .then((response) => response.json());
+   * const server = MCPServer.fromOpenAPI({ spec });
+   * await server.listen(3000);
+   * ```
+   */
+  static fromOpenAPI(options) {
+    const server = new _MCPServer({
+      name: options.name ?? options.spec.info.title,
+      version: options.version ?? options.spec.info.version ?? "1.0.0"
+    });
+    registerOpenAPITools(server, options);
+    return server;
+  }
   /**
    * Create a server. `config.name` and `config.version` identify the server
    * to clients during initialization. `config.basePath` (default `"/mcp"`)