MCP Swagger Server

@andersmandersen

About MCP Swagger Server

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

Config

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

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

Tools

No tools detected

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

FAQ from MCP Swagger Server

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.

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.

Does the server cache the Swagger spec?

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

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.

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.

Frequently asked questions

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.

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`.

Does the server cache the Swagger spec?

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

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.

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

Basic information

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

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.

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K