Advertise
MCP.so
Sign In

MCP Swagger Server

@andersmandersen

Repository

Basic information

Category

Other

Transports

stdio

Author

andersmandersen

About MCP Swagger Server

An MCP server that provides access to Swagger/OpenAPI documentation and allows making API requests based on the specification.

MCP Swagger Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-swagger": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-swagger",
        "."
      ]
    }
  }
}

MCP Swagger Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Swagger Server?

An MCP server that provides access to Swagger/OpenAPI documentation and allows making API requests based on the specification. It is designed for developers who need to interact with APIs described by Swagger specs.

How to use MCP Swagger Server?

Install dependencies with npm install, build TypeScript with npm run build, then run in development mode with npm run dev or production mode with npm run start. Set the required SWAGGER_URL environment variable to the Swagger spec URL; optionally set AUTH_KEY for API key authentication.

Key features of MCP Swagger Server

  • Loads Swagger documentation from a URL
  • Makes API requests based on the Swagger spec
  • Supports authentication via API key
  • Caches Swagger spec for better performance
  • Validates requests against the Swagger spec

Use cases of MCP Swagger Server

  • Browse full Swagger documentation for any API
  • Make GET, POST, or other HTTP requests using spec-defined endpoints
  • Test API endpoints with custom path or query parameters
  • Validate outgoing request parameters against the OpenAPI specification

Frequently asked questions

1

How do I configure the server?

Set the `SWAGGER_URL` environment variable (required) to the URL of your Swagger specification. Optionally set `AUTH_KEY` for API key authentication.

2

What resources and tools does it provide?

It provides a `swagger-doc` resource (URI `swagger://documentation`) for the full spec and a `makeRequest` tool that accepts `path`, `method`, `parameters`, and `body`.

3

Does the server cache the Swagger spec?

Yes, the server caches the Swagger specification for better performance.

4

How do I deploy this server on Smithery.ai?

Build a Docker image with `docker build -t mcp-swagger .`, then run a container with `SWAGGER_URL` and optional `AUTH_KEY`. Configure Smithery with `swaggerUrl` and optional `authKey` in its settings.

5

Is authentication required to make API requests?

No, the `AUTH_KEY` environment variable is optional. Requests can be made without authentication if the API permits it.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise