@tyvm/swagger-mcp 0.0.1

package/README.md

@@ -0,0 +1,91 @@
+# Swagger MCP Generator
+
+Generate MCP (Model Context Protocol) servers from Swagger/OpenAPI specifications.
+
+## Usage
+
+```bash
+npx swagger-mcp-generator <swagger-url> [output-dir] [--start-stdio]
+```
+
+### Examples
+
+```bash
+# Generate MCP server from Swagger spec
+npx swagger-mcp-generator https://api.example.com/swagger.json
+
+# Generate with custom output directory
+npx swagger-mcp-generator https://api.example.com/swagger.json ./my-mcp-server
+
+# Generate and immediately start the server
+npx swagger-mcp-generator https://api.example.com/swagger.json --start-stdio
+
+# Generate with custom output directory and start the server
+npx swagger-mcp-generator https://api.example.com/swagger.json ./my-mcp-server --start-stdio
+
+# Generate with authentication headers
+HEADER_AUTHORIZATION="Bearer abc123" npx swagger-mcp-generator https://api.example.com/swagger.json
+```
+
+## Options
+
+- `--start-stdio` - Automatically build and start the generated MCP server after generation
+  - This will run `npm install`, `npm run build`, and then start the server
+
+## Environment Variables
+
+Set custom headers for API access:
+
+- `HEADER_AUTHORIZATION` - Sets the Authorization header
+- `HEADER_<NAME>` - Sets any custom header (e.g., `HEADER_X_API_KEY`)
+
+## Generated Files
+
+The tool creates:
+
+1. **package.json** - Project configuration with dependencies
+2. **tsconfig.json** - TypeScript configuration
+3. **src/client.ts** - HTTP client functions for each API endpoint
+4. **src/mcp-server.ts** - Complete MCP server implementation
+5. **mcp-server.ts** - Root-level MCP server for direct use
+
+## Using the Generated MCP Server
+
+After generation:
+
+1. Install dependencies: `npm install`
+2. Build the project: `npm run build`
+3. Add to your MCP client configuration:
+
+```json
+{
+  "servers": {
+    "my-api": {
+      "command": "node",
+      "args": ["./path/to/generated/dist/mcp-server.js", "https://api.example.com/swagger.json"],
+      "env": {
+        "HEADER_AUTHORIZATION": "Bearer your-token-here"
+      }
+    }
+  }
+}
+```
+
+## Features
+
+- ✅ Generates MCP tools for all Swagger endpoints
+- ✅ Supports authentication headers via environment variables
+- ✅ Proper TypeScript types and validation
+- ✅ Error handling and logging
+- ✅ Compatible with MCP SDK v1.13.3
+- ✅ Handles query parameters, path parameters, and request bodies
+- ✅ Supports complex object types and arrays
+
+## Requirements
+
+- Node.js 18+
+- Internet access to fetch Swagger specifications
+
+## License
+
+MIT

package/dist/generator.d.ts

@@ -0,0 +1,16 @@
+import { Tool, SwaggerSpec } from './types';
+export declare class SwaggerMcpGenerator {
+    private swaggerSpec;
+    private baseUrl;
+    private headers;
+    constructor(swaggerUrl: string);
+    private setupHeaders;
+    loadSwaggerSpec(): Promise<SwaggerSpec>;
+    private convertSwaggerTypeToToolProp;
+    private resolveSchemaRef;
+    generateTools(): Tool[];
+    generateClientFunctions(): string;
+    generateMcpServer(): string;
+    saveGeneratedFiles(outputDir?: string): Promise<void>;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAY,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAA8B;gBAEjC,UAAU,EAAE,MAAM;IAK9B,OAAO,CAAC,YAAY;IAed,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAmB7C,OAAO,CAAC,4BAA4B;IAqCpC,OAAO,CAAC,gBAAgB;IAgBxB,aAAa,IAAI,IAAI,EAAE;IAkGvB,uBAAuB,IAAI,MAAM;IA+EjC,iBAAiB,IAAI,MAAM;IAqFrB,kBAAkB,CAAC,SAAS,GAAE,MAAsB;CAiE3D"}

package/dist/generator.js

@@ -0,0 +1,393 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerMcpGenerator = void 0;
+const axios_1 = __importDefault(require("axios"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+class SwaggerMcpGenerator {
+    constructor(swaggerUrl) {
+        this.headers = {};
+        this.baseUrl = swaggerUrl;
+        this.setupHeaders();
+    }
+    setupHeaders() {
+        // Parse environment variables for headers starting with HEADER_
+        for (const [key, value] of Object.entries(process.env)) {
+            if (key.startsWith('HEADER_')) {
+                const headerName = key.substring(7); // Remove 'HEADER_' prefix
+                this.headers[headerName] = value || '';
+            }
+        }
+        // Special handling for HEADER_AUTHORIZATION
+        if (process.env.HEADER_AUTHORIZATION) {
+            this.headers['Authorization'] = process.env.HEADER_AUTHORIZATION;
+        }
+    }
+    async loadSwaggerSpec() {
+        try {
+            console.log(`Loading Swagger spec from: ${this.baseUrl}`);
+            const response = await axios_1.default.get(this.baseUrl, {
+                headers: {
+                    'Accept': 'application/json',
+                    ...this.headers
+                }
+            });
+            this.swaggerSpec = response.data;
+            console.log(`Loaded Swagger spec: ${this.swaggerSpec.info.title} v${this.swaggerSpec.info.version}`);
+            return this.swaggerSpec;
+        }
+        catch (error) {
+            console.error('Failed to load Swagger spec:', error.message);
+            throw error;
+        }
+    }
+    convertSwaggerTypeToToolProp(swaggerType) {
+        if (!swaggerType) {
+            return { type: 'string' };
+        }
+        const toolProp = {
+            type: swaggerType.type || 'string',
+            description: swaggerType.description
+        };
+        if (swaggerType.enum) {
+            toolProp.enum = swaggerType.enum;
+        }
+        if (swaggerType.type === 'array' && swaggerType.items) {
+            toolProp.items = {
+                type: swaggerType.items.type || 'string'
+            };
+            if (swaggerType.items.properties) {
+                toolProp.items.properties = {};
+                for (const [key, value] of Object.entries(swaggerType.items.properties)) {
+                    toolProp.items.properties[key] = this.convertSwaggerTypeToToolProp(value);
+                }
+            }
+        }
+        if (swaggerType.type === 'object' && swaggerType.properties) {
+            toolProp.properties = {};
+            for (const [key, value] of Object.entries(swaggerType.properties)) {
+                toolProp.properties[key] = this.convertSwaggerTypeToToolProp(value);
+            }
+        }
+        return toolProp;
+    }
+    resolveSchemaRef(ref) {
+        // Handle OpenAPI 3.0 format
+        if (ref.startsWith('#/components/schemas/')) {
+            const schemaName = ref.replace('#/components/schemas/', '');
+            return this.swaggerSpec.components?.schemas?.[schemaName] || { type: 'string' };
+        }
+        // Handle Swagger 2.0 format
+        if (ref.startsWith('#/definitions/')) {
+            const schemaName = ref.replace('#/definitions/', '');
+            return this.swaggerSpec.definitions?.[schemaName] || { type: 'string' };
+        }
+        return { type: 'string' };
+    }
+    generateTools() {
+        const tools = [];
+        for (const [path, pathItem] of Object.entries(this.swaggerSpec.paths)) {
+            for (const [method, operation] of Object.entries(pathItem)) {
+                if (typeof operation !== 'object' || !operation)
+                    continue;
+                const operationId = operation.operationId || `${method}_${path.replace(/[^a-zA-Z0-9]/g, '_')}`;
+                const summary = operation.summary || `${method.toUpperCase()} ${path}`;
+                const description = operation.description || summary;
+                const properties = {};
+                const required = [];
+                // Add path parameters
+                const pathParams = path.match(/{([^}]+)}/g);
+                if (pathParams) {
+                    for (const param of pathParams) {
+                        const paramName = param.slice(1, -1); // Remove { and }
+                        properties[paramName] = {
+                            type: 'string',
+                            description: `Path parameter: ${paramName}`
+                        };
+                        required.push(paramName);
+                    }
+                }
+                // Add query parameters
+                if (operation.parameters) {
+                    for (const param of operation.parameters) {
+                        if (param.in === 'query') {
+                            // Handle OpenAPI 3.0 format (has schema property)
+                            let schema = param.schema || param;
+                            if (schema && schema.$ref) {
+                                schema = this.resolveSchemaRef(schema.$ref);
+                            }
+                            else if (!schema || !schema.type) {
+                                // Swagger 2.0 format (properties directly on param)
+                                schema = {
+                                    type: param.type || 'string',
+                                    description: param.description
+                                };
+                            }
+                            properties[param.name] = this.convertSwaggerTypeToToolProp(schema);
+                            if (!properties[param.name].description) {
+                                properties[param.name].description = param.description || `Query parameter: ${param.name}`;
+                            }
+                            if (param.required) {
+                                required.push(param.name);
+                            }
+                        }
+                    }
+                }
+                // Add request body properties
+                if (operation.requestBody) {
+                    const content = operation.requestBody.content;
+                    const jsonContent = content['application/json'];
+                    if (jsonContent && jsonContent.schema) {
+                        let schema = jsonContent.schema;
+                        if (schema.$ref) {
+                            schema = this.resolveSchemaRef(schema.$ref);
+                        }
+                        if (schema.properties) {
+                            for (const [key, value] of Object.entries(schema.properties)) {
+                                properties[key] = this.convertSwaggerTypeToToolProp(value);
+                            }
+                            if (schema.required) {
+                                required.push(...schema.required);
+                            }
+                        }
+                    }
+                }
+                const tool = {
+                    type: 'function',
+                    function: {
+                        name: operationId,
+                        description: description,
+                        parameters: {
+                            type: 'object',
+                            properties,
+                            required
+                        }
+                    }
+                };
+                tools.push(tool);
+            }
+        }
+        return tools;
+    }
+    generateClientFunctions() {
+        let clientCode = `
+import axios, { AxiosInstance } from 'axios';
+
+export class SwaggerClient {
+  private api: AxiosInstance;
+  private baseUrl: string;
+
+  constructor(baseUrl: string, headers: Record<string, string> = {}) {
+    this.baseUrl = baseUrl;
+    this.api = axios.create({
+      baseURL: baseUrl,
+      headers: {
+        'Content-Type': 'application/json',
+        ...headers
+      }
+    });
+  }
+
+  private replacePathParams(path: string, params: Record<string, any>): string {
+    let result = path;
+    const pathParams = path.match(/{([^}]+)}/g);
+
+    if (pathParams) {
+      for (const param of pathParams) {
+        const paramName = param.slice(1, -1);
+        if (params[paramName] !== undefined) {
+          result = result.replace(param, params[paramName]);
+          delete params[paramName];
+        }
+      }
+    }
+
+    return result;
+  }
+
+`;
+        for (const [path, pathItem] of Object.entries(this.swaggerSpec.paths)) {
+            for (const [method, operation] of Object.entries(pathItem)) {
+                if (typeof operation !== 'object' || !operation)
+                    continue;
+                const operationId = operation.operationId || `${method}_${path.replace(/[^a-zA-Z0-9]/g, '_')}`;
+                const hasRequestBody = operation.requestBody !== undefined;
+                clientCode += `
+  async ${operationId}(params: Record<string, any> = {}): Promise<any> {
+    const path = this.replacePathParams('${path}', { ...params });
+    const queryParams = { ...params };
+
+    // Remove path parameters from query params
+    const pathParamNames = '${path}'.match(/{([^}]+)}/g);
+    if (pathParamNames) {
+      for (const param of pathParamNames) {
+        const paramName = param.slice(1, -1);
+        delete queryParams[paramName];
+      }
+    }
+
+    ${hasRequestBody ? `
+    const requestBody = { ...queryParams };
+    const response = await this.api.${method}(path, requestBody);
+    ` : `
+    const response = await this.api.${method}(path, { params: queryParams });
+    `}
+
+    return response.data;
+  }
+`;
+            }
+        }
+        clientCode += `
+}
+`;
+        return clientCode;
+    }
+    generateMcpServer() {
+        const tools = this.generateTools();
+        return `#!/usr/bin/env node
+
+import { SwaggerClient } from './client';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+const server = new Server({
+  name: '${this.swaggerSpec.info.title.toLowerCase().replace(/[^a-z0-9]/g, '-')}-mcp',
+  version: '${this.swaggerSpec.info.version}'
+}, {
+  capabilities: {
+    tools: {}
+  }
+});
+
+// Setup headers from environment variables
+const headers: Record<string, string> = {};
+for (const [key, value] of Object.entries(process.env)) {
+  if (key.startsWith('HEADER_') && value) {
+    const headerName = key.substring(7);
+    headers[headerName] = value;
+  }
+}
+
+const swaggerUrl = process.argv[2];
+if (!swaggerUrl) {
+  console.error('Usage: node mcp-server.js <swagger-url>');
+  process.exit(1);
+}
+
+const baseUrl = swaggerUrl.replace(/\\/swagger\\.json$/, '').replace(/\\/docs$/, '');
+const client = new SwaggerClient(baseUrl, headers);
+
+// Helper function to format responses consistently
+const formatResponse = async (methodName: string, args: any) => {
+  try {
+    const result = await (client as any)[methodName](args || {});
+    return {
+      content: [{
+        type: 'text',
+        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2)
+      }]
+    };
+  } catch (error: any) {
+    return {
+      content: [{
+        type: 'text',
+        text: \`Error calling \${methodName}: \${error.message}\`
+      }]
+    };
+  }
+};
+
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params as any;
+
+  switch (name) {
+${tools.map(tool => `    case '${tool.function.name}':
+      return formatResponse('${tool.function.name}', args);`).join('\n')}
+    default:
+      throw new Error(\`Unknown tool: \${name}\`);
+  }
+});
+
+server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+  return {
+    tools: ${JSON.stringify(tools, null, 2)}
+  };
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('${this.swaggerSpec.info.title.replace(/'/g, "\\'")} MCP Server running on stdio');
+}
+
+main().catch(console.error);
+`;
+    }
+    async saveGeneratedFiles(outputDir = './generated') {
+        // Create output directory if it doesn't exist
+        if (!(0, fs_1.existsSync)(outputDir)) {
+            (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+        }
+        // Create src directory
+        const srcDir = (0, path_1.join)(outputDir, 'src');
+        if (!(0, fs_1.existsSync)(srcDir)) {
+            (0, fs_1.mkdirSync)(srcDir, { recursive: true });
+        }
+        const tools = this.generateTools();
+        const clientCode = this.generateClientFunctions();
+        const mcpServer = this.generateMcpServer();
+        // Generate package.json for the output
+        const packageJson = {
+            name: `${this.swaggerSpec.info.title.toLowerCase().replace(/[^a-z0-9]/g, '-')}-mcp`,
+            version: '1.0.0',
+            main: 'dist/mcp-server.js',
+            scripts: {
+                start: 'node dist/mcp-server.js',
+                build: 'tsc'
+            },
+            dependencies: {
+                '@modelcontextprotocol/sdk': '^1.13.3',
+                'axios': '^1.5.0'
+            },
+            devDependencies: {
+                '@types/node': '^20.6.3',
+                'typescript': '^4.6.3'
+            }
+        };
+        // Generate TypeScript config
+        const tsConfig = {
+            compilerOptions: {
+                target: 'es2020',
+                module: 'commonjs',
+                lib: ['es2020'],
+                outDir: './dist',
+                rootDir: './src',
+                strict: true,
+                esModuleInterop: true,
+                skipLibCheck: true,
+                forceConsistentCasingInFileNames: true
+            },
+            include: ['src/**/*'],
+            exclude: ['node_modules', 'dist']
+        };
+        // Save all files
+        (0, fs_1.writeFileSync)((0, path_1.join)(outputDir, 'package.json'), JSON.stringify(packageJson, null, 2));
+        (0, fs_1.writeFileSync)((0, path_1.join)(outputDir, 'tsconfig.json'), JSON.stringify(tsConfig, null, 2));
+        (0, fs_1.writeFileSync)((0, path_1.join)(srcDir, 'client.ts'), clientCode);
+        (0, fs_1.writeFileSync)((0, path_1.join)(srcDir, 'mcp-server.ts'), mcpServer);
+        console.log(`Generated files saved to ${outputDir}/`);
+        console.log(`- package.json: Project configuration`);
+        console.log(`- tsconfig.json: TypeScript configuration`);
+        console.log(`- src/client.ts: HTTP client functions`);
+        console.log(`- src/mcp-server.ts: Complete MCP server implementation`);
+        console.log(`- mcp-server.ts: Complete MCP server implementation`);
+    }
+}
+exports.SwaggerMcpGenerator = SwaggerMcpGenerator;
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,177 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+const fs_1 = require("fs");
+const generator_1 = require("./generator");
+function parseArgs(args) {
+    const parsed = {
+        swaggerUrl: '',
+        outputDir: './generated',
+        startStdio: false
+    };
+    // Filter out the --start-stdio flag first
+    const filteredArgs = args.filter(arg => {
+        if (arg === '--start-stdio') {
+            parsed.startStdio = true;
+            return false;
+        }
+        return true;
+    });
+    // Now parse the remaining arguments in order
+    for (let i = 0; i < filteredArgs.length; i++) {
+        if (!parsed.swaggerUrl) {
+            parsed.swaggerUrl = filteredArgs[i];
+        }
+        else {
+            // Second non-flag argument is the output directory
+            parsed.outputDir = filteredArgs[i];
+            break; // Only take the first two non-flag arguments
+        }
+    }
+    return parsed;
+}
+async function buildAndRunServer(outputDir, swaggerUrl) {
+    console.log('\n🏗️  Building generated server...');
+    // Resolve the output directory to an absolute path to avoid duplication
+    const resolvedOutputDir = (0, path_1.resolve)(outputDir);
+    console.log(`Resolved output directory: ${resolvedOutputDir}`);
+    // Check if package.json exists
+    const packageJsonPath = (0, path_1.join)(resolvedOutputDir, 'package.json');
+    if (!(0, fs_1.existsSync)(packageJsonPath)) {
+        throw new Error(`Generated package.json not found at ${packageJsonPath}`);
+    }
+    // Run npm install
+    await new Promise((resolve, reject) => {
+        console.log('Installing dependencies...');
+        const npmInstall = (0, child_process_1.spawn)('npm', ['install'], {
+            cwd: resolvedOutputDir,
+            stdio: 'inherit'
+        });
+        npmInstall.on('close', (code) => {
+            if (code === 0) {
+                console.log('✅ Dependencies installed successfully');
+                resolve();
+            }
+            else {
+                reject(new Error(`npm install failed with code ${code}`));
+            }
+        });
+        npmInstall.on('error', (error) => {
+            reject(new Error(`Failed to start npm install: ${error.message}`));
+        });
+    });
+    // Run npm run build
+    await new Promise((resolve, reject) => {
+        console.log('Building TypeScript...');
+        const npmBuild = (0, child_process_1.spawn)('npm', ['run', 'build'], {
+            cwd: resolvedOutputDir,
+            stdio: 'inherit'
+        });
+        npmBuild.on('close', (code) => {
+            if (code === 0) {
+                console.log('✅ Build completed successfully');
+                resolve();
+            }
+            else {
+                reject(new Error(`npm run build failed with code ${code}`));
+            }
+        });
+        npmBuild.on('error', (error) => {
+            reject(new Error(`Failed to start npm build: ${error.message}`));
+        });
+    });
+    // Run the MCP server
+    console.log('\n🚀 Starting MCP server...');
+    console.log('Press Ctrl+C to stop the server');
+    const serverPath = (0, path_1.join)(resolvedOutputDir, 'dist', 'mcp-server.js');
+    console.log(`Looking for server at: ${serverPath}`);
+    if (!(0, fs_1.existsSync)(serverPath)) {
+        throw new Error(`Built server not found at ${serverPath}`);
+    }
+    const serverProcess = (0, child_process_1.spawn)('node', [serverPath, swaggerUrl], {
+        cwd: resolvedOutputDir,
+        stdio: 'inherit'
+    });
+    // Handle process termination
+    process.on('SIGINT', () => {
+        console.log('\n🛑 Stopping MCP server...');
+        serverProcess.kill('SIGINT');
+        process.exit(0);
+    });
+    serverProcess.on('close', (code) => {
+        console.log(`MCP server exited with code ${code}`);
+        process.exit(code || 0);
+    });
+    serverProcess.on('error', (error) => {
+        console.error('Failed to start MCP server:', error);
+        process.exit(1);
+    });
+    // Keep the process alive
+    return new Promise(() => { });
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.error('Usage: npx swagger-mcp-generator <swagger-url> [output-dir] [--start-stdio]');
+        console.error('');
+        console.error('Environment variables:');
+        console.error('  HEADER_AUTHORIZATION=Bearer <token>  - Set Authorization header');
+        console.error('  HEADER_<NAME>=<value>               - Set custom header');
+        console.error('');
+        console.error('Examples:');
+        console.error('  npx swagger-mcp-generator https://api.example.com/swagger.json');
+        console.error('  npx swagger-mcp-generator https://api.example.com/swagger.json --start-stdio');
+        console.error('  npx swagger-mcp-generator https://api.example.com/swagger.json ./my-output --start-stdio');
+        console.error('  HEADER_AUTHORIZATION="Bearer abc123" npx swagger-mcp-generator https://api.example.com/swagger.json');
+        process.exit(1);
+    }
+    const { swaggerUrl, outputDir, startStdio } = parseArgs(args);
+    try {
+        const generator = new generator_1.SwaggerMcpGenerator(swaggerUrl);
+        await generator.loadSwaggerSpec();
+        const tools = generator.generateTools();
+        console.log(`Generated ${tools.length} tools from Swagger spec`);
+        await generator.saveGeneratedFiles(outputDir);
+        console.log('');
+        if (startStdio) {
+            console.log('Generation complete! Starting server...');
+            // Build and run the server
+            await buildAndRunServer(outputDir, swaggerUrl);
+        }
+        else {
+            console.log('Generation complete!');
+            // Only show instructions if not starting the server
+            console.log('');
+            console.log('To use the generated MCP server:');
+            console.log(`1. cd ${outputDir}`);
+            console.log('2. npm install');
+            console.log('3. npm run build');
+            console.log('4. Add to your MCP client config:');
+            console.log('{');
+            console.log('  "servers": {');
+            console.log('    "my-api": {');
+            console.log('      "command": "node",');
+            console.log(`      "args": ["${outputDir}/dist/mcp-server.js", "${swaggerUrl}"],`);
+            console.log('      "env": {');
+            console.log('        "HEADER_AUTHORIZATION": "Bearer your-token-here"');
+            console.log('      }');
+            console.log('    }');
+            console.log('  }');
+            console.log('}');
+        }
+    }
+    catch (error) {
+        console.error('Generation failed:', error.message);
+        if (error.response) {
+            console.error('HTTP Status:', error.response.status);
+            console.error('HTTP Headers:', error.response.headers);
+        }
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+export interface ToolProp {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: {
+        type: string;
+        properties?: {
+            [key: string]: ToolProp;
+        };
+    };
+    properties?: {
+        [key: string]: ToolProp;
+    };
+}
+export interface Tool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: {
+                [key: string]: ToolProp;
+            };
+            required: string[];
+        };
+    };
+}
+export interface SwaggerSpec {
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    paths: {
+        [path: string]: {
+            [method: string]: {
+                operationId?: string;
+                summary?: string;
+                description?: string;
+                parameters?: Array<{
+                    name: string;
+                    in: string;
+                    required?: boolean;
+                    schema?: any;
+                    type?: string;
+                    description?: string;
+                }>;
+                requestBody?: {
+                    content: {
+                        [mediaType: string]: {
+                            schema: any;
+                        };
+                    };
+                };
+            };
+        };
+    };
+    components?: {
+        schemas?: {
+            [name: string]: any;
+        };
+    };
+    definitions?: {
+        [name: string]: any;
+    };
+}
+//# 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":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,UAAU,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;KAAE,CAAC;CAC1C;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE;gBAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;aAAE,CAAC;YACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,KAAK,EAAE;QACL,CAAC,IAAI,EAAE,MAAM,GAAG;YACd,CAAC,MAAM,EAAE,MAAM,GAAG;gBAChB,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,OAAO,CAAC,EAAE,MAAM,CAAC;gBACjB,WAAW,CAAC,EAAE,MAAM,CAAC;gBACrB,UAAU,CAAC,EAAE,KAAK,CAAC;oBACjB,IAAI,EAAE,MAAM,CAAC;oBACb,EAAE,EAAE,MAAM,CAAC;oBACX,QAAQ,CAAC,EAAE,OAAO,CAAC;oBACnB,MAAM,CAAC,EAAE,GAAG,CAAC;oBACb,IAAI,CAAC,EAAE,MAAM,CAAC;oBACd,WAAW,CAAC,EAAE,MAAM,CAAC;iBACtB,CAAC,CAAC;gBACH,WAAW,CAAC,EAAE;oBACZ,OAAO,EAAE;wBACP,CAAC,SAAS,EAAE,MAAM,GAAG;4BACnB,MAAM,EAAE,GAAG,CAAC;yBACb,CAAC;qBACH,CAAC;iBACH,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IACF,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE;YACR,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;SACrB,CAAC;KACH,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;KACrB,CAAC;CACH"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@tyvm/swagger-mcp",
+  "version": "0.0.1",
+  "description": "Generate MCP servers from Swagger/OpenAPI specifications",
+  "main": "dist/index.js",
+  "bin": {
+    "swagger-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "swagger",
+    "openapi",
+    "mcp",
+    "model-context-protocol",
+    "api",
+    "generator"
+  ],
+  "author": "Micah Riggan",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.5.0",
+    "@modelcontextprotocol/sdk": "^1.13.3",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.6.3",
+    "typescript": "^4.6.3",
+    "ts-node": "^10.7.0",
+    "jest": "^29.1.1",
+    "@types/jest": "^29.5.13"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "package.json"
+  ],
+  "types": "./dist/index.d.ts"
+}