MCP.so
登录

Swagger MCP Server

@dcolley

基本信息

分类

其他

许可证

Apache-2.0

传输方式

stdio

作者

dcolley

关于 Swagger MCP Server

Swagger to MCP server

Swagger MCP Server 配置

暂无标准配置

该服务器的 README 中没有可解析的 MCP 配置块,请前往代码仓库查看安装说明。

代码仓库

Swagger MCP Server 工具

工具列表暂未提供

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

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

概览

What is Swagger MCP Server?

A server that ingests and serves Swagger/OpenAPI specifications through the Model Context Protocol (MCP). It automatically generates MCP tools from API endpoints and supports multiple authentication methods, making it suitable for developers who want to expose REST APIs to AI assistants via MCP.

How to use Swagger MCP Server?

Clone the repository, install dependencies with Yarn, create a .env file, and configure your Swagger/OpenAPI specification (file path or URL) in config.json. Start the development server with yarn dev, or build and run with yarn build and yarn start. The server listens on configurable host/port and exposes endpoints for health checks, SSE connections, and message posting.

Key features of Swagger MCP Server

  • Loads Swagger/OpenAPI specifications from file or URL
  • Supports Basic Auth, Bearer Token, API Key, and OAuth2 authentication
  • Automatically generates MCP tools from API endpoints
  • Server-Sent Events (SSE) support for real-time communication
  • TypeScript support

Use cases of Swagger MCP Server

  • Integrate any REST API defined by an OpenAPI spec into an MCP ecosystem
  • Allow AI assistants to call API endpoints through auto-generated MCP tools
  • Expose a personal or internal API to MCP clients without writing custom MCP servers

常见问题

1

Is this server safe to expose to the public internet?

No. The README explicitly warns: "This is a personal server!! Do not expose it to the public internet." If the underlying API requires authentication, the MCP server should also not be exposed publicly.

2

What are the runtime prerequisites?

Node.js v18 or higher, the Yarn package manager, and TypeScript.

3

How does the server handle authentication?

It supports Basic Auth, Bearer Token, API Key (in header or query), and OAuth2. The authentication configuration can be provided in `config.json` as a fallback, but the Swagger specification's security schemes take priority.

4

How does the server prioritize settings between the Swagger file and config?

The Swagger specification takes precedence. If the Swagger file contains a `servers` array, the first server URL is used as the base URL. If it defines security schemes, those are used for authentication. The config file settings serve only as fallbacks.

5

What environment variables are available?

- `PORT` (default: 3000) - `API_USERNAME`, `API_PASSWORD` (fallback for basic auth) - `API_TOKEN` (fallback for bearer/OAuth2 tokens) - `DEFAULT_API_BASE_URL` (fallback base URL) - `DEFAULT_SWAGGER_URL` (default Swagger spec URL)

评论

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