Swagger-MCP-server

Swagger-MCP-server is a lightweight Model Context Protocol (MCP) server that interacts with the Swagger Petstore API 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

git clone https://github.com/abhishek-iiit/Swagger-MCP-server.git
cd Swagger-MCP-server

2. Create and activate a virtual environment

python3 -m venv .venv
source .venv/bin/activate

3. Install dependencies

pip install -r requirements.txt

🧪 Running the Server

To start the server:

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:

pip install -r requirements.txt