Swagger

mcp server which will dynamically define tools based on swagger

go

80

GitHub Stars

go

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "danishjsheikh-swagger-mcp": {
      "command": "swagger-mcp",
      "args": [
        "--specUrl=<swagger/doc.json_url>"
      ]
    }
  }
}

swagger-mcp is a tool that discovers MCP-compatible tools by reading a Swagger/OpenAPI specification from a given URL. It extracts the swagger.json file and dynamically exposes a set of MCP tools at runtime so your MCP client can browse and utilize them without manual tool definitions.

How to use

Install swagger-mcp and run it with your Swagger/OpenAPI document. The server will expose generated MCP tools that your MCP client can select and use to interact with the API described by swagger.json.

Start the MCP server that will load your Swagger spec. You will provide the URL to the swagger.json document using the --specUrl flag. 2. Use your MCP client to connect to the server and inspect the dynamically created tools. 3. Choose a tool to perform actions against the API described by swagger.json. 4. If you need to re-scan or reload a new spec, restart swagger-mcp with the new --specUrl.

How to install

Prerequisites you need before installing and running swagger-mcp:

Go toolchain installed (for installation via go install)
A functioning MCP client (such as mcphost) to consume the generated tools
Access to a Swagger/OpenAPI JSON document URL

Step-by-step commands to set up swagger-mcp and run it:

# Install the swagger-mcp binary
go install github.com/danishjsheikh/swagger-mcp@latest

# Run swagger-mcp with your Swagger/OpenAPI JSON URL
swagger-mcp --specUrl=https://your_swagger_api_docs.json