@frontmcp/adapters 0.2.0 → 0.2.2

package/README.md

@@ -1,3 +1,27 @@
-# FrontMcp Adapters
+# FrontMCP Adapters
 
-TBD
+This package contains adapters that extend FrontMCP servers with external capabilities by auto-generating, transforming, or delegating MCP tools.
+
+## Available adapters
+
+### OpenAPI Adapter
+Generate MCP tools from an OpenAPI spec. Each operation becomes an MCP tool with strong input validation and automatic request/response handling.
+
+- Code: `libs/adapters/src/openapi`
+- README: `libs/adapters/src/openapi/README.md`
+- Demo usage: `apps/demo/src/apps/expenses/index.ts`
+- Example spec (used by the demo): https://frontmcp-test.proxy.beeceptor.com/openapi.json
+- Generator library: https://www.npmjs.com/package/openapi-mcp-generator
+
+Quick example:
+```ts
+import { OpenapiAdapter } from '@frontmcp/adapters';
+
+OpenapiAdapter.init({
+  name: 'backend:api',
+  url: 'https://frontmcp-test.proxy.beeceptor.com/openapi.json',
+  baseUrl: 'https://frontmcp-test.proxy.beeceptor.com',
+});
+```
+
+For detailed options and advanced usage, see the adapter README and the docs page `docs/adapters/openapi-adapter.mdx`.

package/package.json

@@ -1,20 +1,21 @@
 {
   "name": "@frontmcp/adapters",
-  "version": "0.2.0",
-  "type": "commonjs",
+  "version": "0.2.2",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
-    "./openapi": {
-      "types": "./src/openapi/index.d.ts",
-      "import": "./src/openapi/index.js",
-      "default": "./src/openapi/index.js"
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "default": "./src/index.js"
     }
   },
   "dependencies": {
     "tslib": "^2.3.0",
+    "@frontmcp/sdk": "^0.2.2",
     "openapi-mcp-generator": "^3.2.0",
     "json-schema-to-zod": "^2.6.1"
-  }
+  },
+  "type": "commonjs"
 }

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export { default as OpenapiAdapter } from './openapi';
+export * from './openapi';

package/src/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenapiAdapter = void 0;
+const tslib_1 = require("tslib");
+var openapi_1 = require("./openapi");
+Object.defineProperty(exports, "OpenapiAdapter", { enumerable: true, get: function () { return tslib_1.__importDefault(openapi_1).default; } });
+tslib_1.__exportStar(require("./openapi"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,qCAAmD;AAA3C,kIAAA,OAAO,OAAkB;AACjC,oDAAyB","sourcesContent":["export {default as OpenapiAdapter} from './openapi'\nexport * from './openapi'"]}

package/src/openapi/openapi.adapter.d.ts

@@ -5,12 +5,4 @@ export default class OpenapiAdapter extends DynamicAdapter<OpenApiAdapterOptions
     constructor(options: OpenApiAdapterOptions);
     fetch(): Promise<FrontMcpAdapterResponse>;
     private parseTools;
-    /**
-     * Converts a JSON Schema to a Zod schema for runtime validation
-     *
-     * @param jsonSchema JSON Schema
-     * @param toolName Tool name for error reporting
-     * @returns Zod schema
-     */
-    private getZodSchemaFromJsonSchema;
 }

package/src/openapi/openapi.adapter.js

@@ -2,67 +2,41 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 const sdk_1 = require("@frontmcp/sdk");
-const zod_1 = require("zod");
 const openapi_mcp_generator_1 = require("openapi-mcp-generator");
-const zod_from_json_schema_1 = require("zod-from-json-schema");
+const openapi_tool_1 = require("./openapi.tool");
 let OpenapiAdapter = class OpenapiAdapter extends sdk_1.DynamicAdapter {
     constructor(options) {
         super();
         this.options = options;
     }
     async fetch() {
-        const openapiLink = this.options.url;
-        const openApiTools = await withSilencedConsole((0, openapi_mcp_generator_1.getToolsFromOpenApi)(openapiLink, {
+        let urlOrSpec = '';
+        if ('url' in this.options) {
+            urlOrSpec = this.options.url;
+        }
+        else if ('spec' in this.options) {
+            urlOrSpec = this.options.spec;
+        }
+        else {
+            throw new Error('Either url or spec must be provided');
+        }
+        const { baseUrl, filterFn, defaultInclude, excludeOperationIds } = this.options;
+        const openApiTools = await (0, openapi_mcp_generator_1.getToolsFromOpenApi)(urlOrSpec, {
+            baseUrl,
+            filterFn,
+            defaultInclude,
+            excludeOperationIds,
             dereference: false,
-        }));
+        });
         return {
             tools: this.parseTools(openApiTools),
         };
     }
     parseTools(openApiTools) {
-        return openApiTools.map(oTool => {
-            const inputSchema = this.getZodSchemaFromJsonSchema(oTool.inputSchema, oTool.name);
-            // const outputSchema = this.getZodSchemaFromJsonSchema(oTool.outputSchema, oTool.name);
-            return (0, sdk_1.tool)({
-                id: oTool.name,
-                name: oTool.name,
-                description: oTool.description,
-                inputSchema: inputSchema.shape,
-                rawInputSchema: oTool.inputSchema,
-                // outputSchema: outputSchema.shape
-            })((input, ctx) => {
-                return {
-                    data: {
-                        id: '1',
-                        name: 'test',
-                    },
-                };
-            });
+        return openApiTools.map(tool => {
+            return (0, openapi_tool_1.createOpenApiTool)(tool, this.options);
         });
     }
-    /**
-     * Converts a JSON Schema to a Zod schema for runtime validation
-     *
-     * @param jsonSchema JSON Schema
-     * @param toolName Tool name for error reporting
-     * @returns Zod schema
-     */
-    getZodSchemaFromJsonSchema(jsonSchema, toolName) {
-        if (typeof jsonSchema !== 'object' || jsonSchema === null) {
-            return zod_1.z.object({}).passthrough();
-        }
-        try {
-            const zodSchema = (0, zod_from_json_schema_1.convertJsonSchemaToZod)(jsonSchema);
-            if (typeof zodSchema?.parse !== 'function') {
-                throw new Error('Eval did not produce a valid Zod schema.');
-            }
-            return zodSchema;
-        }
-        catch (err) {
-            console.error(`Failed to generate/evaluate Zod schema for '${toolName}':`, err);
-            return zod_1.z.object({}).passthrough();
-        }
-    }
 };
 OpenapiAdapter = tslib_1.__decorate([
     (0, sdk_1.Adapter)({
@@ -72,20 +46,4 @@ OpenapiAdapter = tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [Object])
 ], OpenapiAdapter);
 exports.default = OpenapiAdapter;
-async function withSilencedConsole(fn) {
-    const methods = ['log', 'info', 'debug', 'warn', 'error', 'table', 'group', 'groupCollapsed', 'groupEnd', 'dir'];
-    const originals = {};
-    try {
-        for (const m of methods) {
-            originals[m] = console[m];
-            console[m] = () => {
-            };
-        }
-        return await fn;
-    }
-    finally {
-        for (const m of Object.keys(originals))
-            console[m] = originals[m];
-    }
-}
 //# sourceMappingURL=openapi.adapter.js.map

package/src/openapi/openapi.adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.adapter.js","sourceRoot":"","sources":["../../../src/openapi/openapi.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  Adapter,\n  DynamicAdapter,\n  FrontMcpAdapterResponse,\n  tool,\n} from '@frontmcp/sdk';\nimport {OpenApiAdapterOptions} from './openapi.types';\nimport {z} from 'zod';\nimport {getToolsFromOpenApi, McpToolDefinition} from 'openapi-mcp-generator';\nimport {convertJsonSchemaToZod} from 'zod-from-json-schema';\n\n\n@Adapter({\n  name: 'openapi',\n  description: 'OpenAPI adapter that  plugin for expense-mcp',\n})\nexport default class OpenapiAdapter extends DynamicAdapter<OpenApiAdapterOptions> {\n  options: OpenApiAdapterOptions;\n\n  constructor(options: OpenApiAdapterOptions) {\n    super();\n    this.options = options;\n  }\n\n\n  async fetch(): Promise<FrontMcpAdapterResponse> {\n    const openapiLink = this.options.url\n    const openApiTools = await withSilencedConsole(getToolsFromOpenApi(openapiLink, {\n      dereference: false,\n    }));\n\n    return {\n      tools: this.parseTools(openApiTools),\n    };\n  }\n\n  private parseTools(openApiTools: McpToolDefinition[]) {\n    return openApiTools.map(oTool => {\n      const inputSchema = this.getZodSchemaFromJsonSchema(oTool.inputSchema, oTool.name);\n      // const outputSchema = this.getZodSchemaFromJsonSchema(oTool.outputSchema, oTool.name);\n\n      return tool({\n        id: oTool.name,\n        name: oTool.name,\n        description: oTool.description,\n        inputSchema: inputSchema.shape,\n        rawInputSchema: oTool.inputSchema as any,\n        // outputSchema: outputSchema.shape\n      })((input, ctx) => {\n        return {\n          data: {\n            id: '1',\n            name: 'test',\n          },\n        };\n      });\n    });\n  }\n\n\n  /**\n   * Converts a JSON Schema to a Zod schema for runtime validation\n   *\n   * @param jsonSchema JSON Schema\n   * @param toolName Tool name for error reporting\n   * @returns Zod schema\n   */\n  private getZodSchemaFromJsonSchema(jsonSchema: any, toolName: string): z.ZodObject<any> {\n    if (typeof jsonSchema !== 'object' || jsonSchema === null) {\n      return z.object({}).passthrough();\n    }\n    try {\n      const zodSchema = convertJsonSchemaToZod(jsonSchema);\n      if (typeof zodSchema?.parse !== 'function') {\n        throw new Error('Eval did not produce a valid Zod schema.');\n      }\n      return zodSchema as any;\n    } catch (err: any) {\n      console.error(`Failed to generate/evaluate Zod schema for '${toolName}':`, err);\n      return z.object({}).passthrough();\n    }\n  }\n}\n\nasync function withSilencedConsole(fn: Promise<any>) {\n  const methods = ['log', 'info', 'debug', 'warn', 'error', 'table', 'group', 'groupCollapsed', 'groupEnd', 'dir'];\n  const originals = {};\n  try {\n    for (const m of methods) {\n      originals[m] = console[m];\n      console[m] = () => {\n      };\n    }\n    return await fn;\n  } finally {\n    for (const m of Object.keys(originals)) console[m] = originals[m];\n  }\n}\n"]}
+{"version":3,"file":"openapi.adapter.js","sourceRoot":"","sources":["../../../src/openapi/openapi.adapter.ts"],"names":[],"mappings":";;;AAAA,uCAIuB;AAEvB,iEAA6E;AAC7E,iDAAiD;AAOlC,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,oBAAqC;IAG/E,YAAY,OAA8B;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAGD,KAAK,CAAC,KAAK;QACT,IAAI,SAAS,GAAgC,EAAE,CAAA;QAC/C,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QAC/B,CAAC;aAAM,IAAI,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,EAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,mBAAmB,EAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9E,MAAM,YAAY,GAAG,MAAM,IAAA,2CAAmB,EAAC,SAAS,EAAE;YACxD,OAAO;YACP,QAAQ;YACR,cAAc;YACd,mBAAmB;YACnB,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;SACrC,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,YAAiC;QAClD,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC7B,OAAO,IAAA,gCAAiB,EAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AArCoB,cAAc;IAJlC,IAAA,aAAO,EAAC;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8CAA8C;KAC5D,CAAC;;GACmB,cAAc,CAqClC;kBArCoB,cAAc","sourcesContent":["import {\n  Adapter,\n  DynamicAdapter,\n  FrontMcpAdapterResponse,\n} from '@frontmcp/sdk';\nimport {OpenApiAdapterOptions} from './openapi.types';\nimport {getToolsFromOpenApi, McpToolDefinition} from 'openapi-mcp-generator';\nimport {createOpenApiTool} from \"./openapi.tool\";\nimport {OpenAPIV3} from \"openapi-types\";\n\n@Adapter({\n  name: 'openapi',\n  description: 'OpenAPI adapter that  plugin for expense-mcp',\n})\nexport default class OpenapiAdapter extends DynamicAdapter<OpenApiAdapterOptions> {\n  options: OpenApiAdapterOptions;\n\n  constructor(options: OpenApiAdapterOptions) {\n    super();\n    this.options = options;\n  }\n\n\n  async fetch(): Promise<FrontMcpAdapterResponse> {\n    let urlOrSpec: string | OpenAPIV3.Document = ''\n    if ('url' in this.options) {\n      urlOrSpec = this.options.url;\n    } else if ('spec' in this.options) {\n      urlOrSpec = this.options.spec;\n    } else {\n      throw new Error('Either url or spec must be provided');\n    }\n    const {baseUrl, filterFn, defaultInclude, excludeOperationIds} = this.options;\n    const openApiTools = await getToolsFromOpenApi(urlOrSpec, {\n      baseUrl,\n      filterFn,\n      defaultInclude,\n      excludeOperationIds,\n      dereference: false,\n    });\n\n    return {\n      tools: this.parseTools(openApiTools),\n    };\n  }\n\n  private parseTools(openApiTools: McpToolDefinition[]) {\n    return openApiTools.map(tool => {\n      return createOpenApiTool(tool, this.options);\n    });\n  }\n}"]}

package/src/openapi/openapi.tool.d.ts

@@ -0,0 +1,3 @@
+import { McpToolDefinition } from "openapi-mcp-generator";
+import { OpenApiAdapterOptions } from "./openapi.types";
+export declare const createOpenApiTool: (oTool: McpToolDefinition, options: OpenApiAdapterOptions) => () => void;

package/src/openapi/openapi.tool.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenApiTool = void 0;
+const zod_1 = require("zod");
+const sdk_1 = require("@frontmcp/sdk");
+const zod_from_json_schema_1 = require("zod-from-json-schema");
+const createOpenApiTool = (oTool, options) => {
+    const inputSchema = getZodSchemaFromJsonSchema(oTool.inputSchema, oTool.name);
+    const { additionalHeaders, headersMapper } = options;
+    return (0, sdk_1.tool)({
+        id: oTool.name,
+        name: oTool.name,
+        description: oTool.description,
+        inputSchema: inputSchema,
+        rawInputSchema: oTool.inputSchema,
+        // outputSchema: outputSchema.shape
+    })(async (input, ctx) => {
+        let { urlPath, headers, queryParams } = prepareUrl(oTool, input);
+        let requestBodyData = undefined;
+        if (additionalHeaders) {
+            for (const [key, value] of Object.entries(additionalHeaders)) {
+                headers.append(key, value);
+            }
+        }
+        if (typeof headersMapper === 'function') {
+            headers = headersMapper(ctx.authInfo, headers);
+        }
+        if (!['HEAD', 'GET', 'OPTIONS'].includes(oTool.method)) {
+            // prepare body
+            if (oTool.requestBodyContentType && typeof input['requestBody'] !== 'undefined') {
+                requestBodyData = input['requestBody'];
+                headers.set('content-type', oTool.requestBodyContentType);
+            }
+        }
+        const query = queryParams.toString();
+        const url = `${options.baseUrl}${urlPath}${query ? `?${query}` : ''}`;
+        const res = await fetch(url, {
+            method: oTool.method,
+            headers,
+            body: requestBodyData,
+        });
+        const data = await res.text();
+        let result = { data };
+        if (res.headers.get('content-type')?.includes('application/json')) {
+            try {
+                result.data = JSON.parse(data);
+            }
+            catch (e) {
+                console.error("failed to parse api response"); // migrate to logger
+                result.data = data;
+            }
+        }
+        return result;
+    });
+};
+exports.createOpenApiTool = createOpenApiTool;
+/**
+ * Converts a JSON Schema to a Zod schema for runtime validation
+ *
+ * @param jsonSchema JSON Schema
+ * @param toolName Tool name for error reporting
+ * @returns Zod schema
+ */
+function getZodSchemaFromJsonSchema(jsonSchema, toolName) {
+    if (typeof jsonSchema !== 'object' || jsonSchema === null) {
+        return zod_1.z.object({}).passthrough();
+    }
+    try {
+        const zodSchema = (0, zod_from_json_schema_1.convertJsonSchemaToZod)(jsonSchema);
+        if (typeof zodSchema?.parse !== 'function') {
+            throw new Error('Eval did not produce a valid Zod schema.');
+        }
+        return zodSchema;
+    }
+    catch (err) {
+        console.error(`Failed to generate/evaluate Zod schema for '${toolName}':`, err);
+        return zod_1.z.object({}).passthrough();
+    }
+}
+const prepareUrl = (definition, validatedArgs) => {
+    // Prepare URL, query parameters, headers, and request body
+    let urlPath = definition.pathTemplate;
+    const queryParams = new URLSearchParams({ "v": '1' });
+    const headers = new Headers({ 'accept': 'application/json' });
+    // Apply parameters to the URL path, query, or headers
+    definition.executionParameters.forEach((param) => {
+        const value = validatedArgs[param.name];
+        if (typeof value !== 'undefined' && value !== null) {
+            if (param.in === 'path') {
+                urlPath = urlPath.replace(`{${param.name}}`, encodeURIComponent(String(value)));
+            }
+            else if (param.in === 'query') {
+                queryParams.set(param.name, value);
+            }
+            else if (param.in === 'header') {
+                headers.append(param.name.toLowerCase(), String(value));
+            }
+        }
+    });
+    // Ensure all path parameters are resolved
+    if (urlPath.includes('{')) {
+        throw new Error(`Failed to resolve path parameters: ${urlPath}`);
+    }
+    return { urlPath, headers, queryParams };
+};
+//# sourceMappingURL=openapi.tool.js.map

package/src/openapi/openapi.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.tool.js","sourceRoot":"","sources":["../../../src/openapi/openapi.tool.ts"],"names":[],"mappings":"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","sourcesContent":["import {z} from \"zod\";\nimport {McpToolDefinition} from \"openapi-mcp-generator\";\nimport {tool} from \"@frontmcp/sdk\";\nimport {convertJsonSchemaToZod} from \"zod-from-json-schema\";\nimport {OpenApiAdapterOptions} from \"./openapi.types\";\n\n\nexport const createOpenApiTool = (oTool: McpToolDefinition, options: OpenApiAdapterOptions) => {\n  const inputSchema = getZodSchemaFromJsonSchema(oTool.inputSchema, oTool.name);\n\n  const {additionalHeaders, headersMapper} = options;\n  return tool({\n    id: oTool.name,\n    name: oTool.name,\n    description: oTool.description,\n    inputSchema: inputSchema as any,\n    rawInputSchema: oTool.inputSchema as any,\n    // outputSchema: outputSchema.shape\n  })(async (input, ctx) => {\n\n    let {urlPath, headers, queryParams} = prepareUrl(oTool, input);\n    let requestBodyData: any = undefined;\n\n    if (additionalHeaders) {\n      for (const [key, value] of Object.entries(additionalHeaders)) {\n        headers.append(key, value);\n      }\n    }\n    if (typeof headersMapper === 'function') {\n      headers = headersMapper(ctx.authInfo, headers)\n    }\n\n    if (!['HEAD', 'GET', 'OPTIONS'].includes(oTool.method)) {\n      // prepare body\n      if (oTool.requestBodyContentType && typeof input['requestBody'] !== 'undefined') {\n        requestBodyData = input['requestBody'];\n        headers.set('content-type', oTool.requestBodyContentType);\n      }\n    }\n\n    const query = queryParams.toString()\n    const url = `${options.baseUrl}${urlPath}${query ? `?${query}` : ''}`;\n    const res = await fetch(url, {\n      method: oTool.method,\n      headers,\n      body: requestBodyData,\n    });\n    const data = await res.text()\n    let result = {data}\n    if (res.headers.get('content-type')?.includes('application/json')) {\n      try {\n        result.data = JSON.parse(data)\n      } catch (e) {\n        console.error(\"failed to parse api response\")// migrate to logger\n        result.data = data\n      }\n    }\n    return result\n  });\n};\n\n\n/**\n * Converts a JSON Schema to a Zod schema for runtime validation\n *\n * @param jsonSchema JSON Schema\n * @param toolName Tool name for error reporting\n * @returns Zod schema\n */\nfunction getZodSchemaFromJsonSchema(jsonSchema: any, toolName: string): z.ZodObject<any> {\n  if (typeof jsonSchema !== 'object' || jsonSchema === null) {\n    return z.object({}).passthrough();\n  }\n  try {\n    const zodSchema = convertJsonSchemaToZod(jsonSchema);\n    if (typeof zodSchema?.parse !== 'function') {\n      throw new Error('Eval did not produce a valid Zod schema.');\n    }\n    return zodSchema as any;\n  } catch (err: any) {\n    console.error(`Failed to generate/evaluate Zod schema for '${toolName}':`, err);\n    return z.object({}).passthrough();\n  }\n}\n\nconst prepareUrl = (definition: McpToolDefinition, validatedArgs: any) => {\n  // Prepare URL, query parameters, headers, and request body\n  let urlPath = definition.pathTemplate;\n  const queryParams = new URLSearchParams({\"v\": '1'})\n  const headers = new Headers({'accept': 'application/json'})\n\n\n  // Apply parameters to the URL path, query, or headers\n  definition.executionParameters.forEach((param) => {\n    const value = validatedArgs[param.name];\n    if (typeof value !== 'undefined' && value !== null) {\n      if (param.in === 'path') {\n        urlPath = urlPath.replace(`{${param.name}}`, encodeURIComponent(String(value)));\n      } else if (param.in === 'query') {\n        queryParams.set(param.name, value)\n      } else if (param.in === 'header') {\n        headers.append(param.name.toLowerCase(), String(value));\n      }\n    }\n  });\n\n  // Ensure all path parameters are resolved\n  if (urlPath.includes('{')) {\n    throw new Error(`Failed to resolve path parameters: ${urlPath}`);\n  }\n\n  return {urlPath, headers, queryParams};\n}"]}

package/src/openapi/openapi.types.d.ts

@@ -1,18 +1,60 @@
 import { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
-export interface OpenApiAdapterOptions {
+import { GetToolsOptions } from "openapi-mcp-generator/dist/api";
+import { OpenAPIV3 } from "openapi-types";
+interface BaseOptions extends Omit<GetToolsOptions, 'dereference'> {
+    /**
+     * The name of the adapter.
+     * This is used to identify the adapter in the MCP configuration.
+     * Also used to prefix tools if conflicted with other adapters in the same app.
+     */
     name: string;
-    url: string;
+    /**
+     * The base URL of the API.
+     * This is used to construct the full URL for each request.
+     * For example, if the API is hosted at https://api.example.com/v1,
+     * the baseUrl should be set to https://api.example.com/v1.
+     */
+    baseUrl: string;
+    /**
+     * Additional headers to be sent with each request.
+     * This can be used to set authentication headers,
+     * such as Authorization or API Key.
+     */
     additionalHeaders?: Record<string, string>;
-    headersMapper?: (authInfo: AuthInfo, headers: Record<string, string>) => Record<string, string>;
-    bodyMapper?: (authInfo: AuthInfo, body: any) => any;
     /**
      * This can be used to map request information to specific
-     * input schema values as required by the API.
+     * headers as required by the API.
+     * For example, mapping tenantId from authenticated session payload to
+     * a specific header, this key will be hidden to mcp clients
+     * and filled by the adapter before sending the request to the API.
+     * @param authInfo
+     * @param headers
+     */
+    headersMapper?: (authInfo: AuthInfo, headers: Headers) => Headers;
+    /**
+     * This can be used to map request information to specific
+     * body values as required by the API.
      * For example, mapping tenantId from authenticated session payload to
-     * a specific proprty in the input schema, this key will be hidden to mcp clients
+     * a specific property in the body, this key will be hidden to mcp clients
      * and filled by the adapter before sending the request to the API.
+     *
      * @param authInfo
-     * @param request
+     * @param body
      */
-    inputSchemaMapper?: (inputSchema: any) => any;
+    bodyMapper?: (authInfo: AuthInfo, body: any) => any;
+}
+interface SpecOptions extends BaseOptions {
+    /**
+     * The OpenAPI specification the OpenAPI specification.
+     */
+    spec: OpenAPIV3.Document;
+}
+interface UrlOptions extends BaseOptions {
+    /**
+     * The URL of the OpenAPI specification.
+     * Can be a local file path or a remote URL.
+     */
+    url: string;
 }
+export type OpenApiAdapterOptions = SpecOptions | UrlOptions;
+export {};

package/src/openapi/openapi.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.types.js","sourceRoot":"","sources":["../../../src/openapi/openapi.types.ts"],"names":[],"mappings":"","sourcesContent":["import {AuthInfo} from \"@modelcontextprotocol/sdk/server/auth/types.js\";\n\nexport interface OpenApiAdapterOptions {\n  name: string;\n  url: string;\n\n  additionalHeaders?: Record<string, string>;\n  headersMapper?: (authInfo: AuthInfo, headers: Record<string, string>) => Record<string, string>;\n  bodyMapper?: (authInfo: AuthInfo, body: any) => any;\n\n  /**\n   * This can be used to map request information to specific\n   * input schema values as required by the API.\n   * For example, mapping tenantId from authenticated session payload to\n   * a specific proprty in the input schema, this key will be hidden to mcp clients\n   * and filled by the adapter before sending the request to the API.\n   * @param authInfo\n   * @param request\n   */\n  inputSchemaMapper?: (inputSchema: any) => any;\n}\n"]}
+{"version":3,"file":"openapi.types.js","sourceRoot":"","sources":["../../../src/openapi/openapi.types.ts"],"names":[],"mappings":"","sourcesContent":["import {AuthInfo} from \"@modelcontextprotocol/sdk/server/auth/types.js\";\nimport {GetToolsOptions} from \"openapi-mcp-generator/dist/api\";\nimport {OpenAPIV3} from \"openapi-types\";\n\ninterface BaseOptions extends Omit<GetToolsOptions, 'dereference'> {\n  /**\n   * The name of the adapter.\n   * This is used to identify the adapter in the MCP configuration.\n   * Also used to prefix tools if conflicted with other adapters in the same app.\n   */\n  name: string;\n\n  /**\n   * The base URL of the API.\n   * This is used to construct the full URL for each request.\n   * For example, if the API is hosted at https://api.example.com/v1,\n   * the baseUrl should be set to https://api.example.com/v1.\n   */\n  baseUrl: string;\n\n  /**\n   * Additional headers to be sent with each request.\n   * This can be used to set authentication headers,\n   * such as Authorization or API Key.\n   */\n  additionalHeaders?: Record<string, string>;\n  /**\n   * This can be used to map request information to specific\n   * headers as required by the API.\n   * For example, mapping tenantId from authenticated session payload to\n   * a specific header, this key will be hidden to mcp clients\n   * and filled by the adapter before sending the request to the API.\n   * @param authInfo\n   * @param headers\n   */\n  headersMapper?: (authInfo: AuthInfo, headers: Headers) => Headers;\n  /**\n   * This can be used to map request information to specific\n   * body values as required by the API.\n   * For example, mapping tenantId from authenticated session payload to\n   * a specific property in the body, this key will be hidden to mcp clients\n   * and filled by the adapter before sending the request to the API.\n   *\n   * @param authInfo\n   * @param body\n   */\n  bodyMapper?: (authInfo: AuthInfo, body: any) => any;\n}\n\ninterface SpecOptions extends BaseOptions {\n  /**\n   * The OpenAPI specification the OpenAPI specification.\n   */\n  spec: OpenAPIV3.Document;\n}\n\ninterface UrlOptions extends BaseOptions {\n  /**\n   * The URL of the OpenAPI specification.\n   * Can be a local file path or a remote URL.\n   */\n  url: string;\n}\n\nexport type OpenApiAdapterOptions = SpecOptions | UrlOptions;\n"]}