MCP Swagger Server
@andersmandersen
About MCP Swagger Server
An MCP server that provides access to Swagger/OpenAPI documentation and allows making API requests based on the specification.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-swagger": {
"command": "docker",
"args": [
"build",
"-t",
"mcp-swagger",
"."
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
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.
Is authentication required to make API requests?
No, the AUTH_KEY environment variable is optional. Requests can be made without authentication if the API permits it.
More Other MCP servers
MCP Toolbox for Databases
googleapisMCP Toolbox for Databases is an open source MCP server for databases.
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
ICSS
chokcoco不止于 CSS
ghidraMCP
LaurieWiredMCP Server for Ghidra
Comments