Mcp-Swagger-Server

# mcp-swagger-parser > OpenAPI/Swagger specification parser for MCP projects ## 🎯 Overview A TypeScript library for parsing, validating, and extracting information from OpenAPI/Swagger specifications. This library is designed to be the foundation for the MCP Swagger Server ecosystem. ## ✨ Features - 📝 **Multi-format support**: JSON, YAML, URL, and file inputs - 🔍 **Comprehensive validation**: OpenAPI 2.0 and 3.x specification validation - 🛠️ **Information extraction**: Endpoints, schemas, security schemes, and metadata - 🎯 **Type-safe**: Full TypeScript support with comprehensive type definitions - ⚡ **Performance optimized**: Efficient parsing and processing - 🧪 **Well-tested**: High test coverage with unit and integration tests ## 📦 Installation ```bash npm install mcp-swagger-parser ``` ## 🚀 Quick Start ```typescript import { OpenApiParser } from 'mcp-swagger-parser'; const parser = new OpenApiParser(); // Parse from URL const spec = await parser.parseFromUrl('https://petstore.swagger.io/v2/swagger.json'); // Parse from file const spec = await parser.parseFromFile('./api.yaml'); // Parse from text const spec = await parser.parseFromText(yamlContent, 'yaml'); // Extract information console.log('API Info:', spec.info); console.log('Endpoints:', spec.metadata.endpointCount); ``` ## 📚 Documentation - [API Reference](./docs/API.md) - Complete API documentation - [Examples](./docs/examples/) - Usage examples and tutorials - [Migration Guide](./docs/migration.md) - Migration from other parsers ## 🤝 Contributing This package is part of the MCP Swagger Server monorepo. Please see the [main repository](../../README.md) for contribution guidelines. ## 📄 License MIT License - see [LICENSE](../../LICENSE) for details. ## 🔗 Related Packages - [@mcp-swagger/server](../mcp-swagger-server/) - MCP protocol server - [@mcp-swagger/ui](../mcp-swagger-ui/) - Web interface --- **Status**: 🚧 In Development | Part of MCP Swagger Server v1.0.0