swagger-mcp

Name: swagger-mcp
Author: danishjsheikh

@danishjsheikh

代码仓库

关于 swagger-mcp

mcp server which will dynamically define tools based on swagger

基本信息

分类

其他

许可证

MIT

运行时

传输方式

stdio

发布者

danishjsheikh

提交者

凯田

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is swagger-mcp?

swagger-mcp is a tool that reads a Swagger 2.0 or OpenAPI 3.0 specification and dynamically generates MCP tools at runtime—one tool per API endpoint. It is designed for MCP clients to enable LLM-driven API interaction.

How to use swagger-mcp?

Install via go install github.com/danishjsheikh/swagger-mcp@latest, then run it with a spec URL. Use flags like --specUrl, --sse, --http, --security, and --includePaths to configure authentication, transports, and endpoint filtering. Integrate with MCP clients (e.g., mcphost) via a .mcp.json config.

Key features of swagger-mcp

Dynamically generates MCP tools from Swagger/OpenAPI specs
Supports Swagger 2.0 and OpenAPI 3.0
Handles path, query, header parameters and request bodies
Honors required/optional fields from schema required arrays
Runs in stdio, SSE, or StreamableHTTP mode
Supports authentication: basic, bearer, API key
Allows path/method include/exclude filtering

Use cases of swagger-mcp

Enable LLMs to call any API documented by an OpenAPI spec
Quickly prototype an MCP server for a REST API without manual coding
Filter specific endpoints or HTTP methods for focused LLM interactions
Integrate with MCP-compatible clients like mcphost for agentic workflows

FAQ from swagger-mcp

What spec formats does swagger-mcp support?

Swagger 2.0 (swagger: "2.0") and OpenAPI 3.0 (openapi: "3.0.x"), including inline and $ref schemas for request bodies and parameters.

What runtime dependencies are required?

An LLM model API key (OpenAI, Claude, or local models via Ollama) and any MCP client (e.g., mcphost). The server itself is a Go binary.

How do I pass authentication credentials?

Use the --security flag (basic, bearer, or apiKey) along with the corresponding flag (--basicAuth, --bearerAuth, or --apiKeyAuth). For API key, specify passAs (header/query/cookie) and the key-value pair.

Can I filter which endpoints become tools?

Yes, use --includePaths or --excludePaths for path filtering and --includeMethods or --excludeMethods for HTTP method filtering.

How does swagger-mcp handle request bodies?

Swagger 2.0 in: body parameters and OpenAPI 3.0 requestBody.content.<media-type>.schema are supported. Fields in the required array become required MCP tool arguments; others are optional.