@emcy/openapi-to-mcp 0.2.0

package/dist/__tests__/integration.test.js

@@ -0,0 +1,184 @@
+/**
+ * Integration tests - end-to-end generation flow
+ */
+import { describe, it, expect } from 'vitest';
+import { parseOpenAPI, generateOperationId } from '../parser.js';
+import { mapToMcpTools } from '../mapper.js';
+import { generateMcpServer } from '../generator.js';
+/**
+ * Sample OpenAPI spec similar to what the SampleApi produces
+ * Note: No operationIds defined - they should be generated consistently
+ */
+const sampleApiSpec = {
+    openapi: '3.0.1',
+    info: {
+        title: 'Sample API',
+        description: 'A sample API for products and orders',
+        version: 'v1',
+    },
+    paths: {
+        '/Orders': {
+            get: {
+                tags: ['Orders'],
+                responses: { '200': { description: 'OK' } },
+            },
+            post: {
+                tags: ['Orders'],
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    productId: { type: 'integer' },
+                                    customerName: { type: 'string' },
+                                    quantity: { type: 'integer' },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: { '200': { description: 'OK' } },
+            },
+        },
+        '/Orders/{id}': {
+            get: {
+                tags: ['Orders'],
+                parameters: [
+                    { name: 'id', in: 'path', required: true, schema: { type: 'integer' } },
+                ],
+                responses: { '200': { description: 'OK' } },
+            },
+            delete: {
+                tags: ['Orders'],
+                parameters: [
+                    { name: 'id', in: 'path', required: true, schema: { type: 'integer' } },
+                ],
+                responses: { '200': { description: 'OK' } },
+            },
+        },
+        '/Products': {
+            get: {
+                tags: ['Products'],
+                responses: { '200': { description: 'OK' } },
+            },
+            post: {
+                tags: ['Products'],
+                requestBody: {
+                    content: {
+                        'application/json': {
+                            schema: {
+                                type: 'object',
+                                properties: {
+                                    name: { type: 'string' },
+                                    price: { type: 'number' },
+                                },
+                            },
+                        },
+                    },
+                },
+                responses: { '200': { description: 'OK' } },
+            },
+        },
+        '/Products/{id}': {
+            get: {
+                tags: ['Products'],
+                parameters: [
+                    { name: 'id', in: 'path', required: true, schema: { type: 'integer' } },
+                ],
+                responses: { '200': { description: 'OK' } },
+            },
+        },
+    },
+};
+describe('End-to-end generation', () => {
+    it('should generate tools from OpenAPI spec without operationIds', async () => {
+        const parsed = await parseOpenAPI(sampleApiSpec);
+        expect(parsed.title).toBe('Sample API');
+        expect(parsed.endpoints.length).toBe(7);
+        // Verify generated operationIds match expected format
+        const operationIds = parsed.endpoints.map(e => e.operationId);
+        expect(operationIds).toContain('GetOrders');
+        expect(operationIds).toContain('PostOrders');
+        expect(operationIds).toContain('GetOrdersById');
+        expect(operationIds).toContain('DeleteOrdersById');
+        expect(operationIds).toContain('GetProducts');
+        expect(operationIds).toContain('PostProducts');
+        expect(operationIds).toContain('GetProductsById');
+    });
+    it('should map parsed endpoints to MCP tools', async () => {
+        const parsed = await parseOpenAPI(sampleApiSpec);
+        const tools = mapToMcpTools(parsed.endpoints);
+        expect(tools.length).toBe(7);
+        const getOrders = tools.find(t => t.name === 'GetOrders');
+        expect(getOrders).toBeDefined();
+        expect(getOrders?.httpMethod).toBe('get');
+        expect(getOrders?.pathTemplate).toBe('/Orders');
+        const postOrders = tools.find(t => t.name === 'PostOrders');
+        expect(postOrders).toBeDefined();
+        expect(postOrders?.requestBodyContentType).toBe('application/json');
+        const getOrderById = tools.find(t => t.name === 'GetOrdersById');
+        expect(getOrderById).toBeDefined();
+        expect(getOrderById?.parameters).toHaveLength(1);
+        expect(getOrderById?.parameters[0].name).toBe('id');
+    });
+    it('should generate MCP server with all tools', async () => {
+        const parsed = await parseOpenAPI(sampleApiSpec);
+        const tools = mapToMcpTools(parsed.endpoints);
+        const files = generateMcpServer(tools, {
+            name: 'sample-api-mcp',
+            version: '1.0.0',
+            baseUrl: 'http://localhost:5158',
+            emcyEnabled: true,
+        });
+        const serverCode = files['src/index.ts'];
+        // Verify all tools are in the generated code
+        expect(serverCode).toContain('["GetOrders"');
+        expect(serverCode).toContain('["PostOrders"');
+        expect(serverCode).toContain('["GetOrdersById"');
+        expect(serverCode).toContain('["DeleteOrdersById"');
+        expect(serverCode).toContain('["GetProducts"');
+        expect(serverCode).toContain('["PostProducts"');
+        expect(serverCode).toContain('["GetProductsById"');
+        // Verify the toolDefinitionMap is not empty
+        expect(serverCode).not.toMatch(/const toolDefinitionMap.*=.*new Map\(\[\s*\]\)/);
+    });
+    it('should filter endpoints when enabledPaths is provided', async () => {
+        const parsed = await parseOpenAPI(sampleApiSpec);
+        const enabledPaths = new Set(['GET:/Orders', 'POST:/Orders']);
+        const tools = mapToMcpTools(parsed.endpoints, enabledPaths);
+        expect(tools.length).toBe(2);
+        expect(tools.map(t => t.name)).toEqual(['GetOrders', 'PostOrders']);
+    });
+});
+describe('operationId consistency', () => {
+    /**
+     * This test ensures the wizard's operationId generation matches the generator's.
+     * The wizard uses generateOperationId (duplicated in actions.ts) to create IDs,
+     * and the generator uses the same logic in parser.ts.
+     *
+     * If these don't match, the wizard's endpoint selection won't correctly
+     * filter the generator's tools, resulting in empty tool definitions.
+     */
+    it('should generate consistent operationIds across different methods and paths', () => {
+        const testCases = [
+            { method: 'get', path: '/users', expected: 'GetUsers' },
+            { method: 'GET', path: '/users', expected: 'GetUsers' },
+            { method: 'post', path: '/users', expected: 'PostUsers' },
+            { method: 'get', path: '/users/{id}', expected: 'GetUsersById' },
+            { method: 'delete', path: '/users/{id}', expected: 'DeleteUsersById' },
+            { method: 'get', path: '/orders/{orderId}/items', expected: 'GetOrdersByOrderIdItems' },
+            { method: 'patch', path: '/orders/{id}/status', expected: 'PatchOrdersByIdStatus' },
+            { method: 'get', path: '/api/v1/products', expected: 'GetApiV1Products' },
+            { method: 'get', path: '/', expected: 'Get' },
+            { method: 'get', path: '/Orders', expected: 'GetOrders' },
+            { method: 'post', path: '/Orders', expected: 'PostOrders' },
+            { method: 'get', path: '/Orders/{id}', expected: 'GetOrdersById' },
+        ];
+        for (const { method, path, expected } of testCases) {
+            const result = generateOperationId(method, path);
+            expect(result, `generateOperationId('${method}', '${path}')`).toBe(expected);
+        }
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/__tests__/integration.test.js.map

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

package/dist/__tests__/mapper.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Mapper tests - ensures endpoints are correctly mapped to MCP tool definitions
+ */
+export {};
+//# sourceMappingURL=mapper.test.d.ts.map

package/dist/__tests__/mapper.test.d.ts.map

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

package/dist/__tests__/mapper.test.js

@@ -0,0 +1,250 @@
+/**
+ * Mapper tests - ensures endpoints are correctly mapped to MCP tool definitions
+ */
+import { describe, it, expect } from 'vitest';
+import { mapToMcpTools, getEndpointKey, getAllEndpointKeys } from '../mapper.js';
+describe('mapToMcpTools', () => {
+    it('should map a simple GET endpoint to a tool', () => {
+        const endpoints = [
+            {
+                operationId: 'getUsers',
+                method: 'GET',
+                path: '/users',
+                summary: 'Get all users',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools).toHaveLength(1);
+        expect(tools[0]).toEqual({
+            name: 'getUsers',
+            description: 'Get all users',
+            inputSchema: { type: 'object', properties: {} },
+            httpMethod: 'get',
+            pathTemplate: '/users',
+            parameters: [],
+            requestBodyContentType: undefined,
+            securitySchemes: [],
+        });
+    });
+    it('should map path parameters to input schema', () => {
+        const endpoints = [
+            {
+                operationId: 'getUser',
+                method: 'GET',
+                path: '/users/{id}',
+                summary: 'Get user by ID',
+                parameters: [
+                    {
+                        name: 'id',
+                        in: 'path',
+                        required: true,
+                        schema: { type: 'integer', description: 'User ID' },
+                    },
+                ],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools[0].inputSchema).toEqual({
+            type: 'object',
+            properties: {
+                id: { type: 'integer', description: 'User ID' },
+            },
+            required: ['id'],
+        });
+        expect(tools[0].parameters).toEqual([
+            { name: 'id', in: 'path', required: true, schema: { type: 'integer', description: 'User ID' } },
+        ]);
+    });
+    it('should map query parameters to input schema', () => {
+        const endpoints = [
+            {
+                operationId: 'searchUsers',
+                method: 'GET',
+                path: '/users',
+                summary: 'Search users',
+                parameters: [
+                    {
+                        name: 'q',
+                        in: 'query',
+                        required: false,
+                        schema: { type: 'string' },
+                        description: 'Search query',
+                    },
+                    {
+                        name: 'limit',
+                        in: 'query',
+                        required: false,
+                        schema: { type: 'integer', default: 10 },
+                    },
+                ],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools[0].inputSchema.properties).toEqual({
+            q: { type: 'string', description: 'Search query' },
+            limit: { type: 'integer', default: 10 },
+        });
+        // Neither parameter is required, so required array should not exist
+        expect(tools[0].inputSchema.required).toBeUndefined();
+    });
+    it('should map request body to input schema', () => {
+        const endpoints = [
+            {
+                operationId: 'createUser',
+                method: 'POST',
+                path: '/users',
+                summary: 'Create a user',
+                parameters: [],
+                requestBody: {
+                    required: true,
+                    contentType: 'application/json',
+                    schema: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                            email: { type: 'string' },
+                        },
+                        required: ['name', 'email'],
+                    },
+                },
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools[0].inputSchema.properties?.requestBody).toBeDefined();
+        expect(tools[0].inputSchema.required).toContain('requestBody');
+        expect(tools[0].requestBodyContentType).toBe('application/json');
+    });
+    it('should include description from endpoint', () => {
+        const endpoints = [
+            {
+                operationId: 'getUser',
+                method: 'GET',
+                path: '/users/{id}',
+                summary: 'Get user by ID',
+                description: 'Retrieves a single user by their unique identifier.',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools[0].description).toBe('Get user by ID\n\nRetrieves a single user by their unique identifier.');
+    });
+    it('should generate description from path when no summary', () => {
+        const endpoints = [
+            {
+                operationId: 'deleteUser',
+                method: 'DELETE',
+                path: '/users/{id}',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools[0].description).toBe('Executes DELETE /users/{id}');
+    });
+    it('should map multiple endpoints', () => {
+        const endpoints = [
+            {
+                operationId: 'getUsers',
+                method: 'GET',
+                path: '/users',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+            {
+                operationId: 'createUser',
+                method: 'POST',
+                path: '/users',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+            {
+                operationId: 'getUser',
+                method: 'GET',
+                path: '/users/{id}',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools).toHaveLength(3);
+        expect(tools.map(t => t.name)).toEqual(['getUsers', 'createUser', 'getUser']);
+    });
+    it('should filter by enabled paths when provided', () => {
+        const endpoints = [
+            {
+                operationId: 'getUsers',
+                method: 'GET',
+                path: '/users',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+            {
+                operationId: 'createUser',
+                method: 'POST',
+                path: '/users',
+                parameters: [],
+                securitySchemes: [],
+                tags: [],
+            },
+        ];
+        const enabledPaths = new Set(['GET:/users']);
+        const tools = mapToMcpTools(endpoints, enabledPaths);
+        expect(tools).toHaveLength(1);
+        expect(tools[0].name).toBe('getUsers');
+    });
+    it('should preserve security schemes', () => {
+        const endpoints = [
+            {
+                operationId: 'getSecureData',
+                method: 'GET',
+                path: '/secure',
+                parameters: [],
+                securitySchemes: ['bearerAuth', 'apiKey'],
+                tags: [],
+            },
+        ];
+        const tools = mapToMcpTools(endpoints);
+        expect(tools[0].securitySchemes).toEqual(['bearerAuth', 'apiKey']);
+    });
+});
+describe('getEndpointKey', () => {
+    it('should generate correct key format', () => {
+        const endpoint = {
+            operationId: 'getUsers',
+            method: 'GET',
+            path: '/users',
+            parameters: [],
+            securitySchemes: [],
+            tags: [],
+        };
+        expect(getEndpointKey(endpoint)).toBe('GET:/users');
+    });
+});
+describe('getAllEndpointKeys', () => {
+    it('should return all endpoint keys', () => {
+        const endpoints = [
+            { operationId: 'a', method: 'GET', path: '/users', parameters: [], securitySchemes: [], tags: [] },
+            { operationId: 'b', method: 'POST', path: '/users', parameters: [], securitySchemes: [], tags: [] },
+            { operationId: 'c', method: 'DELETE', path: '/users/{id}', parameters: [], securitySchemes: [], tags: [] },
+        ];
+        const keys = getAllEndpointKeys(endpoints);
+        expect(keys).toEqual(['GET:/users', 'POST:/users', 'DELETE:/users/{id}']);
+    });
+});
+//# sourceMappingURL=mapper.test.js.map

package/dist/__tests__/mapper.test.js.map

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

package/dist/__tests__/parser.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parser tests - ensures OpenAPI specs are correctly parsed into our format
+ */
+export {};
+//# sourceMappingURL=parser.test.d.ts.map

package/dist/__tests__/parser.test.d.ts.map

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