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).
Swagger MCP Server
@hauntingsteps
Basic information
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.
RepositorySwagger 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
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.
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.
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.
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.
More Other MCP servers
Awesome Mlops
visengerA curated list of references for MLOps
14.0K
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
26.0K
EverArt
modelcontextprotocolModel Context Protocol Servers
88.1K
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
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.
Comments