@emcy/openapi-to-mcp 0.2.0

package/dist/mapper.js

@@ -0,0 +1,79 @@
+/**
+ * Tool Mapper - Maps OpenAPI endpoints to MCP tool definitions
+ */
+/**
+ * Map OpenAPI endpoints to MCP tool definitions
+ */
+export function mapToMcpTools(endpoints, enabledPaths) {
+    return endpoints
+        .filter((endpoint) => {
+        if (!enabledPaths)
+            return true;
+        const key = `${endpoint.method}:${endpoint.path}`;
+        return enabledPaths.has(key);
+    })
+        .map((endpoint) => mapEndpointToTool(endpoint));
+}
+function mapEndpointToTool(endpoint) {
+    const inputSchema = buildInputSchema(endpoint);
+    // Build description from summary and path
+    let description = endpoint.summary || `Executes ${endpoint.method} ${endpoint.path}`;
+    if (endpoint.description && endpoint.description !== endpoint.summary) {
+        description += `\n\n${endpoint.description}`;
+    }
+    return {
+        name: endpoint.operationId,
+        description,
+        inputSchema,
+        httpMethod: endpoint.method.toLowerCase(),
+        pathTemplate: endpoint.path,
+        parameters: endpoint.parameters,
+        requestBodyContentType: endpoint.requestBody?.contentType,
+        securitySchemes: endpoint.securitySchemes,
+    };
+}
+function buildInputSchema(endpoint) {
+    const properties = {};
+    const required = [];
+    // Add parameters to schema
+    for (const param of endpoint.parameters) {
+        properties[param.name] = {
+            ...param.schema,
+            description: param.description || param.schema.description,
+        };
+        if (param.required) {
+            required.push(param.name);
+        }
+    }
+    // Add request body to schema
+    if (endpoint.requestBody) {
+        properties.requestBody = {
+            ...endpoint.requestBody.schema,
+            description: "The JSON request body.",
+        };
+        if (endpoint.requestBody.required) {
+            required.push("requestBody");
+        }
+    }
+    const schema = {
+        type: "object",
+        properties,
+    };
+    if (required.length > 0) {
+        schema.required = required;
+    }
+    return schema;
+}
+/**
+ * Generate a unique key for an endpoint
+ */
+export function getEndpointKey(endpoint) {
+    return `${endpoint.method}:${endpoint.path}`;
+}
+/**
+ * Get all endpoint keys from a list of endpoints
+ */
+export function getAllEndpointKeys(endpoints) {
+    return endpoints.map(getEndpointKey);
+}
+//# sourceMappingURL=mapper.js.map

package/dist/mapper.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * OpenAPI Parser - Parses OpenAPI 3.x specs and extracts endpoint information
+ */
+import type { ParsedOpenAPI } from './types.js';
+/**
+ * Parse an OpenAPI specification from a string (JSON or YAML) or URL
+ */
+export declare function parseOpenAPI(input: string | object): Promise<ParsedOpenAPI>;
+/**
+ * Validate an OpenAPI specification
+ */
+export declare function validateOpenAPI(input: string | object): Promise<{
+    valid: boolean;
+    errors?: string[];
+}>;
+/**
+ * Generate a consistent operationId from method and path.
+ *
+ * IMPORTANT: This function is duplicated in:
+ *   - emcy/src/Emcy.Web/app/[lng]/components/wizard/actions.ts
+ *
+ * Both implementations MUST stay in sync! If you modify this function,
+ * update the wizard's generateOperationId() function as well.
+ *
+ * Examples:
+ *   GET /users -> GetUsers
+ *   GET /users/{id} -> GetUsersById
+ *   POST /orders/{orderId}/items -> PostOrdersByOrderIdItems
+ */
+export declare function generateOperationId(method: string, path: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAmB,aAAa,EAAwE,MAAM,YAAY,CAAC;AAQvI;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAKjF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAQ5G;AAmJD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAcxE"}

package/dist/parser.js

@@ -0,0 +1,183 @@
+/**
+ * OpenAPI Parser - Parses OpenAPI 3.x specs and extracts endpoint information
+ */
+import SwaggerParser from '@apidevtools/swagger-parser';
+/**
+ * Parse an OpenAPI specification from a string (JSON or YAML) or URL
+ */
+export async function parseOpenAPI(input) {
+    // Dereference resolves all $ref pointers
+    const api = await SwaggerParser.dereference(input);
+    return extractFromSpec(api);
+}
+/**
+ * Validate an OpenAPI specification
+ */
+export async function validateOpenAPI(input) {
+    try {
+        await SwaggerParser.validate(input);
+        return { valid: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { valid: false, errors: [message] };
+    }
+}
+function extractFromSpec(api) {
+    const endpoints = [];
+    const securitySchemes = {};
+    // Extract security schemes
+    const components = api.components;
+    if (components?.securitySchemes) {
+        for (const [name, scheme] of Object.entries(components.securitySchemes)) {
+            if (!isReference(scheme)) {
+                securitySchemes[name] = extractSecurityScheme(scheme);
+            }
+        }
+    }
+    // Extract base URL from servers
+    const baseUrl = api.servers?.[0]?.url || '';
+    // Extract endpoints from paths
+    if (api.paths) {
+        for (const [path, pathItem] of Object.entries(api.paths)) {
+            if (!pathItem || isReference(pathItem))
+                continue;
+            const methods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+            for (const method of methods) {
+                const operation = pathItem[method];
+                if (!operation)
+                    continue;
+                const endpoint = extractEndpoint(path, method.toUpperCase(), operation, pathItem.parameters);
+                endpoints.push(endpoint);
+            }
+        }
+    }
+    return {
+        title: api.info.title,
+        version: api.info.version,
+        description: api.info.description,
+        baseUrl,
+        endpoints,
+        securitySchemes,
+    };
+}
+function extractEndpoint(path, method, operation, pathParameters) {
+    const parameters = [];
+    // Combine path-level and operation-level parameters
+    const allParams = [...(pathParameters || []), ...(operation.parameters || [])];
+    for (const param of allParams) {
+        if (isReference(param))
+            continue;
+        parameters.push(extractParameter(param));
+    }
+    // Extract request body
+    let requestBody;
+    if (operation.requestBody && !isReference(operation.requestBody)) {
+        requestBody = extractRequestBody(operation.requestBody);
+    }
+    // Extract security requirements
+    const securitySchemes = [];
+    const security = operation.security || [];
+    for (const req of security) {
+        securitySchemes.push(...Object.keys(req));
+    }
+    // Generate operationId if not present
+    const operationId = operation.operationId || generateOperationId(method, path);
+    return {
+        operationId,
+        method,
+        path,
+        summary: operation.summary,
+        description: operation.description,
+        parameters,
+        requestBody,
+        securitySchemes,
+        tags: operation.tags || [],
+    };
+}
+function extractParameter(param) {
+    return {
+        name: param.name,
+        in: param.in,
+        required: param.required || false,
+        schema: param.schema || { type: 'string' },
+        description: param.description,
+    };
+}
+function extractRequestBody(body) {
+    const content = body.content;
+    // Prefer JSON content type
+    const jsonContent = content?.['application/json'];
+    if (jsonContent?.schema) {
+        return {
+            required: body.required || false,
+            contentType: 'application/json',
+            schema: jsonContent.schema,
+        };
+    }
+    // Fallback to first available content type
+    const [contentType, mediaType] = Object.entries(content || {})[0] || [];
+    if (contentType && mediaType?.schema) {
+        return {
+            required: body.required || false,
+            contentType,
+            schema: mediaType.schema,
+        };
+    }
+    return undefined;
+}
+function extractSecurityScheme(scheme) {
+    const result = {
+        type: scheme.type,
+    };
+    if (scheme.type === 'apiKey') {
+        result.name = scheme.name;
+        result.in = scheme.in;
+    }
+    else if (scheme.type === 'http') {
+        result.scheme = scheme.scheme;
+        result.bearerFormat = scheme.bearerFormat;
+    }
+    else if (scheme.type === 'oauth2' && 'flows' in scheme) {
+        result.flows = scheme.flows;
+    }
+    else if (scheme.type === 'openIdConnect' && 'openIdConnectUrl' in scheme) {
+        result.openIdConnectUrl = scheme.openIdConnectUrl;
+    }
+    return result;
+}
+/**
+ * Generate a consistent operationId from method and path.
+ *
+ * IMPORTANT: This function is duplicated in:
+ *   - emcy/src/Emcy.Web/app/[lng]/components/wizard/actions.ts
+ *
+ * Both implementations MUST stay in sync! If you modify this function,
+ * update the wizard's generateOperationId() function as well.
+ *
+ * Examples:
+ *   GET /users -> GetUsers
+ *   GET /users/{id} -> GetUsersById
+ *   POST /orders/{orderId}/items -> PostOrdersByOrderIdItems
+ */
+export function generateOperationId(method, path) {
+    // Convert path like /users/{id}/posts to UsersByIdPosts
+    const pathParts = path
+        .split('/')
+        .filter(Boolean)
+        .map(part => {
+        if (part.startsWith('{') && part.endsWith('}')) {
+            return 'By' + capitalize(part.slice(1, -1));
+        }
+        return capitalize(part);
+    })
+        .join('');
+    return capitalize(method.toLowerCase()) + pathParts;
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function isReference(obj) {
+    return typeof obj === 'object' && obj !== null && '$ref' in obj;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Types for OpenAPI to MCP conversion
+ */
+export interface OpenAPIEndpoint {
+    operationId: string;
+    method: string;
+    path: string;
+    summary?: string;
+    description?: string;
+    parameters: EndpointParameter[];
+    requestBody?: RequestBodySchema;
+    securitySchemes: string[];
+    tags: string[];
+}
+export interface EndpointParameter {
+    name: string;
+    in: 'path' | 'query' | 'header' | 'cookie';
+    required: boolean;
+    schema: JSONSchemaType;
+    description?: string;
+}
+export interface RequestBodySchema {
+    required: boolean;
+    contentType: string;
+    schema: JSONSchemaType;
+}
+export interface JSONSchemaType {
+    type?: string | string[];
+    format?: string;
+    properties?: Record<string, JSONSchemaType>;
+    items?: JSONSchemaType;
+    required?: string[];
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    additionalProperties?: boolean | JSONSchemaType;
+    oneOf?: JSONSchemaType[];
+    anyOf?: JSONSchemaType[];
+    allOf?: JSONSchemaType[];
+    $ref?: string;
+}
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JSONSchemaType;
+    httpMethod: string;
+    pathTemplate: string;
+    parameters: EndpointParameter[];
+    requestBodyContentType?: string;
+    securitySchemes: string[];
+}
+export interface ParsedOpenAPI {
+    title: string;
+    version: string;
+    description?: string;
+    baseUrl?: string;
+    endpoints: OpenAPIEndpoint[];
+    securitySchemes: Record<string, SecurityScheme>;
+}
+export interface SecurityScheme {
+    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+    name?: string;
+    in?: 'header' | 'query' | 'cookie';
+    scheme?: string;
+    bearerFormat?: string;
+    flows?: OAuthFlows;
+    openIdConnectUrl?: string;
+}
+export interface OAuthFlows {
+    implicit?: OAuthFlow;
+    password?: OAuthFlow;
+    clientCredentials?: OAuthFlow;
+    authorizationCode?: OAuthFlow;
+}
+export interface OAuthFlow {
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    refreshUrl?: string;
+    scopes: Record<string, string>;
+}
+export interface GeneratorOptions {
+    name: string;
+    version?: string;
+    baseUrl: string;
+    enabledEndpoints?: Set<string>;
+    emcyEnabled?: boolean;
+    /**
+     * For local development: path to local @emcy/sdk package.
+     * When set, generated package.json will use "file:<path>" instead of npm version.
+     * Example: "../../packages/emcy-sdk" or "/absolute/path/to/emcy-sdk"
+     */
+    localSdkPath?: string;
+}
+export interface GeneratedFiles {
+    [path: string]: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for OpenAPI to MCP conversion
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@emcy/openapi-to-mcp",
+  "version": "0.2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "description": "Convert OpenAPI specifications to MCP (Model Context Protocol) servers with optional Emcy telemetry",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openapi-to-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "openapi",
+    "swagger",
+    "ai",
+    "claude",
+    "cursor",
+    "llm",
+    "tools",
+    "api",
+    "generator",
+    "emcy"
+  ],
+  "author": "Emcy <hello@emcy.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emcy-ai/openapi-to-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/emcy-ai/openapi-to-mcp/issues"
+  },
+  "homepage": "https://emcy.ai",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^10.1.1",
+    "openapi-types": "^12.1.3",
+    "yaml": "^2.7.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.2",
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0"
+  }
+}