Skip to main content
Glama
abhishek-iiit

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.


Related MCP server: Swagger MCP Server

๐Ÿš€ Installation Guide

  1. Clone the repository

git clone https://github.com/abhishek-iiit/Swagger-MCP-server.git cd Swagger-MCP-server
  1. Create and activate a virtual environment

python3 -m venv .venv source .venv/bin/activate
  1. 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
-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/abhishek-iiit/Swagger-MCP-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server