Swagger MCP Server

# Swagger-MCP-server **Swagger-MCP-server** is a lightweight Model Context Protocol (MCP) server that interacts with the [Swagger Petstore API](https://petstore.swagger.io/) using an OpenAPI 3.0 specification. The server dynamically loads API tools defined in `openapi.json` and exposes endpoints that mimic those of the Petstore API using the `mcp.server.fastmcp` module. --- ## 📦 Features - ✅ Dynamic loading of OpenAPI 3.0 spec (Petstore). - 🐾 Full support for Petstore operations: Pets, Stores, Users. - ⚡ Built using FastAPI. - 🛠️ Utilizes the `mcp` server CLI and dynamic tool registration. --- ## 🚀 Installation Guide 1. **Clone the repository** ```bash git clone https://github.com/abhishek-iiit/Swagger-MCP-server.git cd Swagger-MCP-server ``` 2. **Create and activate a virtual environment** ```bash python3 -m venv .venv source .venv/bin/activate ``` 3. **Install dependencies** ```bash pip install -r requirements.txt ``` # 🧪 Running the Server To start the server: ```bash python main.py ``` This will start an MCP server that registers endpoints as defined in the openapi.json file and serves them via the Petstore API interface. # 📚 API Endpoints The server mirrors the Swagger Petstore API. It includes operations for: ## Pets - Add a new pet - Update an existing pet - Find pets by status or tags - Get pet by ID - Delete a pet - Stores - Place an order - Get order by ID - Check inventory - Users - Create users - Login/logout - Get user by username - Update/delete user # 📦 Dependencies Dependencies are listed in requirements.txt and include: - fastapi: High-performance API framework. - httpx: Async-compatible HTTP client. - mcp[cli]: Model Context Protocol server framework. - jsonschema: JSON Schema validation. Install them via: ```bash pip install -r requirements.txt ```