Mcp-Swagger-Server

Mcp-Swagger-Server

Converts OpenAPI/Swagger specs into MCP format for AI-ready REST APIs.

40
Stars
9
Forks
1
Releases

Overview

MCP Swagger Server is a tool that converts OpenAPI/Swagger specifications into the Model Context Protocol (MCP) format. It provides zero-configuration transformation so REST APIs defined by OpenAPI become MCP-enabled tools for AI agents. The project includes multiple packages: mcp-swagger-server (core server), mcp-swagger-parser (OpenAPI parser), mcp-swagger-ui (UI in development), and mcp-swagger-api (backend). Core features include zero-config conversion, a progressive CLI that guides users through configuration, support for multiple transport protocols (SSE, Streamable, Stdio), and Bearer Token authentication to protect API access. Quick Start instructions show how to install globally, run with custom OpenAPI URLs, apply operation filters, and optionally use a config file. The README also demonstrates environment-variable configuration and Claude Desktop integration for AI workflows. In short, the MCP Swagger Server enables AI systems to interact with REST APIs by translating API definitions into MCP and offering flexible deployment options.

Details

Owner
zaizaizhao
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Zero-config conversion

Input an OpenAPI specification to automatically generate MCP tooling for AI-ready interaction.

Progressive Command-Line Interface

Guided CLI that assists users in configuring and running the MCP server.

Multi-Transport Protocols

Supports SSE, Streamable, and Stdio transports for MCP communication.

Bearer Token Authentication

Security feature to protect API access via Bearer tokens.

Audience

AI developersEnable AI assistants to interact with REST APIs via MCP.

Tags

OpenAPISwaggerMCPModel Context ProtocolREST APIBearer TokenCLIZero-configSSEStreamableStdioAI assistants