广告合作
MCP.so
登录

Swagger MCP Server

@danishjsheikh

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

danishjsheikh

提交者

凯 田

关于 Swagger MCP Server

mcp server which will dynamically define tools based on swagger

Swagger MCP Server 配置

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

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

Swagger MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

1

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.

2

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.

3

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.

4

Can I filter which endpoints become tools?

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

5

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.

评论

其他 分类下的更多 MCP 服务器

ICSS

chokcoco

不止于 CSS

20.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

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.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Volley.sh

Volley

A 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

广告合作