A Model Context Protocol server for Swagger/OpenAPI endpoints. This tool allows you to expose Swagger-defined APIs through the Model Context Protocol, making them accessible to AI agents.
You can install the package globally:
npm install -g swagger-mcp-server
Or use it directly with npx:
npx swagger-mcp-server <config-file>
- Create a configuration file (JSON) that defines the Swagger endpoints you want to expose:
{
"endpoints": [
{
"name": "example-api",
"url": "https://example.com/api/swagger.json"
}
]
}
- Run the server:
swagger-mcp-server config.json
Or with npx:
npx swagger-mcp-server config.json
The configuration file supports the following options:
-
endpoints
: An array of Swagger endpoints to expose-
name
: A unique identifier for the endpoint -
url
: URL to the Swagger/OpenAPI JSON definition
-
To build the project:
npm run build
To run locally:
npm run run
ISC