MCP.so
Sign In

Swagger MCP Server

@hauntingsteps

Basic information

Category

Other

License

MIT license

Transports

stdio

Author

hauntingsteps

About Swagger MCP Server

mcp server which will dynamically define tools based on swagger

Swagger MCP 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.

Repository

Swagger MCP 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 swagger-mcp?

swagger-mcp is a tool that scrapes a Swagger UI by extracting the swagger.json file and dynamically generates well-defined MCP (Model Context Protocol) tools at runtime. It is intended for developers using an MCP client who need to expose API endpoints from a Swagger/OpenAPI specification as MCP tools.

How to use swagger-mcp?

Install via Go: go install github.com/hauntingsteps/swagger-mcp@latest. Run with swagger-mcp --specUrl=https://your_swagger_api_docs.json. Optionally configure SSE mode, authentication, or base URL via flags. Then integrate with an MCP client (e.g., mark3labs/mcphost) by adding a command entry in .mcp.json.

Key features of swagger-mcp

  • Dynamically generates MCP tools from any Swagger/OpenAPI JSON spec.
  • Supports stdio and SSE transport modes.
  • Offers authentication: basic, API key, and bearer token.
  • Allows base URL override for API requests.
  • Easy integration with MCP clients like mcphost.

Use cases of swagger-mcp

  • Exposing a REST API defined by Swagger as MCP tools for an LLM agent.
  • Rapidly prototyping tool calls from an OpenAPI specification without manual tool definition.
  • Running a local MCP server that proxies a third-party API with authentication.

Frequently asked questions

1

What prerequisites are needed?

You need an LLM model API key (OpenAI, Claude) or a local LLM (e.g., Ollama), and any MCP client (such as mark3labs/mcphost).

2

How do I configure authentication?

Use the `--security` flag with value `basic`, `apiKey`, or `bearer`, and supply the corresponding credential flag (`--basicAuth`, `--bearerAuth`, or `--apiKeyAuth`). API key details are given in `passAs:name=value` format.

3

Can swagger-mcp run as an SSE server?

Yes. Use the `--sseMode=true` flag. Optionally set `--sseAddr` and `--sseUrl` to control the server address and base URL.

4

What Swagger specification format does it expect?

It expects a URL pointing to a JSON file (e.g., `swagger.json` or `openapi.json`) served by the Swagger UI or directly accessible.

5

What is the runtime dependency?

swagger-mcp is a Go binary. You must have Go installed to run `go install`, or download the prebuilt binary if available. No additional runtime dependencies are required beyond the LLM access and MCP client.

Comments

More Other MCP servers