About Swagger MCP Server
Swagger MCP Server is an MCP server published by gulbaki in the Documentation category.
The repository has 14 stars and 3 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/gulbaki/swagger-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Swagger MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 2 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
Swagger/OpenAPI MCP Server
A Model Context Protocol (MCP) server that allows LLMs to explore and interact with Swagger/OpenAPI specifications. This server provides tools and resources for loading API specifications, browsing endpoints, and getting detailed information about API operations.
Installation
- Clone or create the project directory
- Install dependencies:
npm install
- Build the TypeScript code:
npm run build
Usage
Available Tools
load_api
Load an OpenAPI/Swagger specification into the server.
Parameters:
apiId(string): Unique identifier for this APIsource(string): URL or file path to the OpenAPI/Swagger specification
Example:
{
"name": "load_api",
"arguments": {
"apiId": "petstore",
"source": "https://petstore.swagger.io/v2/swagger.json"
}
}
get_endpoint_details
Get detailed information about a specific API endpoint.
Parameters:
apiId(string): ID of the loaded APImethod(string): HTTP method (GET, POST, etc.)path(string): API endpoint pathnatural(boolean, optional): If true, returns a human-readable summary
Example:
{
"name": "get_endpoint_details",
"arguments": {
"apiId": "petstore",
"method": "GET",
"path": "/pet/{petId}",
"natural": true
}
}
list_apis
List all currently loaded API specifications.
Parameters: None
search_endpoints
Search for endpoints matching a specific pattern.
Parameters:
apiId(string): ID of the loaded APIpattern(string): Search pattern for endpoint paths or descriptions
Example:
{
"name": "search_endpoints",
"arguments": {
"apiId": "petstore",
"pattern": "pet"
}
}
Available Resources
swagger://{apiId}/load
Get overview information about a loaded API specification.
swagger://{apiId}/endpoints
Get a list of all available endpoints for an API.
swagger://{apiId}/endpoint/{method}/{path}
Get detailed information about a specific endpoint.
Configuration with Claude Desktop
To use this server with Claude Desktop, add the following to your claude_desktop_config.json:
{
"mcpServers": {
"swagger-explorer": {
"command": "node",
"args": ["/path/to/your/swagger-mcp-server/build/index.js"]
}
}
}
Replace /path/to/your/swagger-mcp-server with the actual path to your project directory.
License
MIT License
README fetched from the repository 2 days ago. The original is authoritative.