Happy slice of mcp pizzaMCP.pizza

Swagger-MCP

MCP.Pizza Chef: Vizioz

Strictly a builder's tool. Six tools read a Swagger or OpenAPI file and print TypeScript back at you: the list of operations a service offers, the data shapes each one expects, and a ready-to-paste tool definition for a connector you are writing yourself. It produces source code, never a working connector, so there is nothing here for someone who simply wants a task done. You clone and build it with Node, and no key or account is required.

Coding

Use This MCP server To

List every operation a service offers before I code Generate the data shapes one operation expects Get a starting tool definition for my own connector Read a Swagger file without wading through it by hand Cache a remote service description for offline work

README

Swagger MCP

An MCP server that connects to a Swagger specification and helps an AI to build all the required models to generate a MCP server for that service.

Features

  • Downloads a Swagger specification and stores it locally for faster reference.
  • Returns a list of all the endpoints and their HTTP Methods and descriptions
  • Returns a list of all the models
  • Returns a model
  • Returns service to connect to the end point
  • Returns MCP function definitions
  • Generates complete MCP tool definitions with full schema information
  • Includes AI-specific instructions in tool descriptions

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/readingdancer/swagger-mcp.git
cd swagger-mcp
  1. Install dependencies:
npm install
  1. Create a .env file based on the .env.example file:
cp .env.example .env
  1. Update the .env file.

Configuration

Edit the .env file to configure the application:

  • PORT: The port on which the server will run (default: 3000)
  • NODE_ENV: The environment (development, production, test)
  • LOG_LEVEL: Logging level (info, error, debug)

Usage

Swagger-MCP FAQ

Will this connect my assistant to a service?
No. It writes TypeScript source code for a connector that you then build yourself. Nothing it produces runs on its own.
Do I need an account or a key?
No. It reads a public service description, either from a web address you give it or from a file already on your computer.
How hard is setup?
It is for developers only. You clone the repository, install packages with Node, and build it before your editor can see the tools.
Which apps does it work in?
The instructions are written for Cursor, and it runs in any app that can start a locally built tool.
Can I point it at a file instead of a web address?
Yes, but only if you did not start it with a service address on the command line. When that is set, the file path you pass is quietly ignored.
How many tools does it actually offer?
Six. The README documents five and leaves out a small version-reporting tool.
Is it still maintained?
It is not archived and was last changed in December 2025, though the README's clone command still points at a different, older copy of the project.