@frontmcp/adapters 0.1.2

package/README.md

@@ -0,0 +1,3 @@
+# FrontMcp Adapters
+
+TBD

package/package.json

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

package/src/openapi/index.d.ts

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

package/src/openapi/index.js

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

package/src/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/openapi/index.ts"],"names":[],"mappings":";;;;AAAA,qDAA4C;AAAnC,mIAAA,OAAO,OAAA;AAChB,0DAAgC","sourcesContent":["export { default } from './openapi.adapter';\nexport * from './openapi.types';\n"]}

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

@@ -0,0 +1,16 @@
+import { DynamicAdapter, FrontMcpAdapterResponse } from '@frontmcp/sdk';
+import { OpenApiAdapterOptions } from './openapi.types';
+export default class OpenapiAdapter extends DynamicAdapter<OpenApiAdapterOptions> {
+    options: 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

@@ -0,0 +1,91 @@
+"use strict";
+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");
+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, {
+            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',
+                    },
+                };
+            });
+        });
+    }
+    /**
+     * 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)({
+        name: 'openapi',
+        description: 'OpenAPI adapter that  plugin for expense-mcp',
+    }),
+    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

@@ -0,0 +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"]}

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

@@ -0,0 +1,18 @@
+import { AuthInfo } from "@modelcontextprotocol/sdk/server/auth/types.js";
+export interface OpenApiAdapterOptions {
+    name: string;
+    url: string;
+    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.
+     * For example, mapping tenantId from authenticated session payload to
+     * a specific proprty in the input schema, this key will be hidden to mcp clients
+     * and filled by the adapter before sending the request to the API.
+     * @param authInfo
+     * @param request
+     */
+    inputSchemaMapper?: (inputSchema: any) => any;
+}

package/src/openapi/openapi.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=openapi.types.js.map

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

@@ -0,0 +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"]}