Swagger MCP Server

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

Clone the repository

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

Create and activate a virtual environment

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

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

A lightweight server that enables interaction with the Swagger Petstore API using the Model Context Protocol, allowing operations on pets, stores, and users through dynamically loaded OpenAPI specifications.

Related MCP Servers

Swagger MCP Server
dcolley
-
security
A
license
-
quality
A server that enables interaction with any API that has a Swagger/OpenAPI specification through Model Context Protocol (MCP), automatically generating tools from API endpoints and supporting multiple authentication methods.
Last updated -
34
90
TypeScript
Apache 2.0
Swagger MCP Server
tuskermanshu
A
security
F
license
A
quality
A server based on Model Context Protocol that parses Swagger/OpenAPI documents and generates TypeScript types and API client code for different frameworks (Axios, Fetch, React Query).
Last updated -
12
7
13
TypeScript
FastMCP
ryuichi1208
-
security
F
license
-
quality
A lightweight Model Context Protocol server that enables creating, managing, and querying model contexts with integrated Datadog metrics and monitoring.
Last updated -
Python
MockLoop MCP Serverofficial
MockLoop
-
security
A
license
-
quality
A Model Context Protocol server that generates and runs mock API servers from API documentation like OpenAPI/Swagger specs, enabling developers and AI assistants to quickly spin up mock backends for development and testing.
Last updated -
8
Python
MIT License

View all related MCP servers

Swagger MCP Server