What are the runtime requirements?
Node.js ≥ 20.0.0 and pnpm ≥ 8.0.0 (recommended).
MCP Swagger Server
@zaizaizhao
Basic information
About MCP Swagger Server
MCP Swagger Server 将任何符合 OpenAPI/Swagger 规范的 REST API 转换为 Model Context Protocol (MCP) 格式，让 AI 助手能够理解和调用您的 API。
MCP Swagger Server config
No standard config provided
This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.
RepositoryMCP 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?
Mcp Swagger Server (MSS) is a tool that converts OpenAPI/Swagger specifications into tools compatible with the Model Context Protocol (MCP). It enables AI assistants to call REST APIs by automatically generating MCP tool definitions from an OpenAPI document. The tool is intended for developers who want to expose existing REST APIs to MCP‑based AI clients without manual integration.
How to use Mcp Swagger Server?
Install via npm: npm i mcp-swagger-server -g. Run the interactive CLI with mss, or use command-line flags for non‑interactive startup, e.g., mss --openapi <url> --transport stdio. Configuration can be provided via CLI options, a .env file, or a JSON config file (--config).
Key features of Mcp Swagger Server
- Zero‑configuration conversion from OpenAPI to MCP tools
- Interactive CLI for step‑by‑step setup
- Supports SSE, Streamable, and Stdio transports
- Bearer token authentication for secured APIs
- Operation filtering by HTTP method, path, operation ID, and parameters
Use cases of Mcp Swagger Server
- Connecting a Swagger‑defined REST API to Claude Desktop as a set of MCP tools
- Converting a private API with Bearer token authentication for use with MCP clients
- Rapidly prototyping AI‑tool interfaces from existing OpenAPI 2.0/3.x documents
Frequently asked questions
What transport protocols are supported?
Stdio, SSE, and Streamable. Interactive mode does not support STDIO; use `mss --openapi ... --transport stdio` for STDIO.
How do I authenticate API calls with Bearer token?
Use `--auth-type bearer` and either `--bearer-token` (direct token) or `--bearer-env` (environment variable). Tokens can also be placed in a `.env` file.
Can I filter which operations are exposed as tools?
Yes. Use flags such as `--operation-filter-methods`, `--operation-filter-paths`, `--operation-filter-operation-ids`, and `--operation-filter-parameters` to limit the generated tools.
Does the tool support OpenAPI 2.0 (Swagger)?
Yes. Swagger 2.0 documents are automatically converted to OpenAPI 3.x at startup, including mapping of `host/basePath`.
More Other MCP servers
Volley.sh
VolleyA good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi
Klarix Intelligence Engine
KlarixB2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.
Soar Flight Booking MCP
Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.
Handl
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
39.5K
Comments