Swagger to MCP

# Swagger to MCP Server Convert any Swagger/OpenAPI specification into a dynamic Model Context Protocol (MCP) server. ## Features - 🚀 Automatically generates MCP tools from Swagger/OpenAPI specs - 📘 Supports both local files (.yaml, .yml, .json) and remote URLs - ✅ Built-in JSON schema validation using AJV - 🔄 Dynamic endpoint mapping with path parameters - 🪶 Generates MCP manifest (mcp.json) for easy integration ## Installation ```bash pnpm install ``` ## Usage ### Start the MCP server ```bash pnpm start ``` Or with a custom Swagger file: ```bash node server.js --swagger=./path/to/your/spec.yaml ``` ### Generate manifest only (without starting server) ```bash node server.js --swagger=./petstore.yaml --manifest-only ``` ### Use a remote Swagger URL ```bash node server.js --swagger=https://petstore.swagger.io/v2/swagger.json ``` ## Configuration Create a `.env` file to configure the server: ```env MCP_PORT=4000 ``` ## How It Works 1. **Load Swagger/OpenAPI spec** - From local file or URL 2. **Parse endpoints** - Extract all paths and operations 3. **Generate MCP tools** - Each endpoint becomes an MCP tool with: - Input schema validation - Output schema definition - HTTP request handler 4. **Start MCP server** - Listen on configured port and handle tool requests ## Example The included `petstore.yaml` provides a simple example: ```yaml openapi: 3.0.1 info: title: Swagger Petstore version: 1.0.0 servers: - url: https://petstore.swagger.io/v2 paths: /pet/{petId}: get: summary: Find pet by ID operationId: getPetById parameters: - name: petId in: path required: true schema: type: integer responses: '200': description: successful operation ``` This generates an MCP tool that can fetch pet information by ID. ## License MIT