MCP Swagger Server

Name: MCP Swagger Server
Author: andersmandersen

@andersmandersen

关于 MCP Swagger Server

An MCP server that provides access to Swagger/OpenAPI documentation and allows making API requests based on the specification.

基本信息

分类

其他

运行时

node

传输方式

stdio

发布者

andersmandersen

配置

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

{
  "mcpServers": {
    "mcp-swagger": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-swagger",
        "."
      ]
    }
  }
}

工具

未检测到工具

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

概览

What is MCP Swagger Server?

An MCP server that provides access to Swagger/OpenAPI documentation and allows making API requests based on the specification. It is designed for developers who need to interact with APIs described by Swagger specs.

How to use MCP Swagger Server?

Install dependencies with npm install, build TypeScript with npm run build, then run in development mode with npm run dev or production mode with npm run start. Set the required SWAGGER_URL environment variable to the Swagger spec URL; optionally set AUTH_KEY for API key authentication.

Key features of MCP Swagger Server

Loads Swagger documentation from a URL
Makes API requests based on the Swagger spec
Supports authentication via API key
Caches Swagger spec for better performance
Validates requests against the Swagger spec

Use cases of MCP Swagger Server

Browse full Swagger documentation for any API
Make GET, POST, or other HTTP requests using spec-defined endpoints
Test API endpoints with custom path or query parameters
Validate outgoing request parameters against the OpenAPI specification

FAQ from MCP Swagger Server

How do I configure the server?

Set the SWAGGER_URL environment variable (required) to the URL of your Swagger specification. Optionally set AUTH_KEY for API key authentication.

What resources and tools does it provide?

It provides a swagger-doc resource (URI swagger://documentation) for the full spec and a makeRequest tool that accepts path, method, parameters, and body.

Does the server cache the Swagger spec?

Yes, the server caches the Swagger specification for better performance.

How do I deploy this server on Smithery.ai?

Build a Docker image with docker build -t mcp-swagger ., then run a container with SWAGGER_URL and optional AUTH_KEY. Configure Smithery with swaggerUrl and optional authKey in its settings.