swagger-mcp-server

1.0.1 • Public • Published

Swagger MCP Server

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.

Installation

You can install the package globally:

npm install -g swagger-mcp-server

Or use it directly with npx:

npx swagger-mcp-server <config-file>

Usage

  1. 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"
    }
  ]
}
  1. Run the server:
swagger-mcp-server config.json

Or with npx:

npx swagger-mcp-server config.json

Configuration Options

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

Development

To build the project:

npm run build

To run locally:

npm run run

License

ISC

Package Sidebar

Install

npm i swagger-mcp-server

Weekly Downloads

17

Version

1.0.1

License

ISC

Unpacked Size

20.5 kB

Total Files

7

Last publish

Collaborators

  • suchar