Skip to main content
Glama
deenesjakoruzh

Swagger MCP Server

by dcolley
npmGitHub
TypeScript
Apache 2.0
21
103
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Swagger MCP Server

A server that ingests and serves Swagger/OpenAPI specifications through the Model Context Protocol (MCP).

Features

  • Loads Swagger/OpenAPI specifications

  • Supports multiple authentication methods:

    • Basic Auth

    • Bearer Token

    • API Key (header or query)

    • OAuth2

  • Automatically generates MCP tools from API endpoints

  • Server-Sent Events (SSE) support for real-time communication

  • TypeScript support

Security

This is a personal server!! Do not expose it to the public internet. If the underlying API requires authentication, you should not expose the MCP server to the public internet.

TODO

  • secrets - the MCP server should be able to use secrets from the user to authenticate requests to the API

  • Comprehensive test suite

Prerequisites

  • Node.js (v18 or higher)

  • Yarn package manager

  • TypeScript

Installation

  1. Clone the repository:

git clone https://github.com/dcolley/swagger-mcp.git cd swagger-mcp

  1. Install dependencies:

yarn install

  1. Create a .env file based on the example:

cp .env.example .env

  1. Configure your Swagger/OpenAPI specification:

    • Place your Swagger file in the project (e.g., swagger.json)

    • Or provide a URL to your Swagger specification

  2. Update the configuration in config.json with your server settings:

{ "server": { "host": "localhost", "port": 3000 }, "swagger": { "url": "url-or-path/to/your/swagger.json", "apiBaseUrl": "https://api.example.com", // Fallback if not specified in Swagger "defaultAuth": { // Fallback if not specified in Swagger "type": "apiKey", "apiKey": "your-api-key", "apiKeyName": "api_key", "apiKeyIn": "header" } } }

Note: The server prioritizes settings from the Swagger specification over the config file:

  • If the Swagger file contains a servers array, the first server URL will be used as the base URL

  • If the Swagger file defines security schemes, they will be used for authentication

  • The config file settings serve as fallbacks when not specified in the Swagger file

Usage

  1. Start the development server:

yarn dev

  1. Build for production:

yarn build

  1. Start the production server:

yarn start

API Endpoints

  • GET /health - Check server health status

  • GET /sse - Establish Server-Sent Events connection

  • POST /messages - Send messages to the MCP server

Testing

Run the test suite:

# Run tests once yarn test # Run tests in watch mode yarn test:watch # Run tests with coverage report yarn test:coverage

Authentication

The server supports various authentication methods. Configure them in the config.json file as fallbacks when not specified in the Swagger file:

Basic Auth

{ "defaultAuth": { "type": "basic", "username": "your-username", "password": "your-password" } }

Bearer Token

{ "defaultAuth": { "type": "bearer", "token": "your-bearer-token" } }

API Key

{ "defaultAuth": { "type": "apiKey", "apiKey": "your-api-key", "apiKeyName": "X-API-Key", "apiKeyIn": "header" } }

OAuth2

{ "defaultAuth": { "type": "oauth2", "token": "your-oauth-token" } }

Development

  1. Start the development server:

yarn dev

License

This project is licensed under the Apache 2.0 License.

Environment Variables

  • PORT: Server port (default: 3000)

  • API_USERNAME: Username for API authentication (fallback)

  • API_PASSWORD: Password for API authentication (fallback)

  • API_TOKEN: API token for authentication (fallback)

  • DEFAULT_API_BASE_URL: Default base URL for API endpoints (fallback)

  • DEFAULT_SWAGGER_URL: Default Swagger specification URL

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

  1. Features
    1. Security
      1. TODO
        1. Prerequisites
          1. Installation
            1. Usage
              1. API Endpoints
                1. Testing
                  1. Authentication
                    1. Basic Auth
                    2. Bearer Token
                    3. API Key
                    4. OAuth2
                  2. Development
                    1. License
                      1. Environment Variables

                        Related Resources

                        Related MCP Servers

                        • Swagger MCP

                          Vizioz
                          A
                          security
                          A
                          license
                          A
                          quality
                          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.
                          Last updated -
                          5
                          21
                          77
                          MIT License
                          • Linux
                          • Apple

                        • 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
                          12
                          16

                        • OpenAPI Schema Explorer

                          kadykov
                          A
                          security
                          A
                          license
                          A
                          quality
                          MCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.
                          Last updated -
                          10
                          52
                          MIT License

                        • OpenAPI to MCP Server

                          TykTechnologies
                          A
                          security
                          A
                          license
                          A
                          quality
                          A tool that creates MCP (Model Context Protocol) servers from OpenAPI/Swagger specifications, enabling AI assistants to interact with your APIs.
                          Last updated -
                          3
                          9
                          25
                          MIT License
                          • Apple

                        View all related MCP servers

                        Appeared in Searches

                        New MCP Servers

                        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/dcolley/swagger-mcp'

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