Skip to content

API Reference

TypeDoc-generated API documentation for Swagger MCP Server.

Modules

This section contains auto-generated documentation from the TypeScript source code.

Available Modules

ModuleDescription
GlobalsGlobal exports and type definitions

Source Structure

src/
├── index.ts                 # MCP server entry point
├── services/
│   ├── config-loader.ts     # swagger-targets.json loader
│   ├── swagger-parser.ts    # OpenAPI parsing
│   └── http-client.ts       # API testing & cURL generation
├── tools/
│   └── swagger-tools.ts     # 10 MCP tools implementation
└── types/
    └── swagger.ts           # TypeScript type definitions

Key Exports

Types

  • SwaggerSpec - Parsed Swagger/OpenAPI specification
  • EndpointInfo - API endpoint information
  • RequestConfig - HTTP request configuration
  • ApiResponse - API response structure

Services

  • SwaggerParserService - Parses and caches Swagger/OpenAPI specs
  • loadTargets() - Loads swagger-targets.json configuration
  • executeRequest() - Executes HTTP requests
  • generateCurl() - Generates cURL commands

Tools

10 MCP tools for Swagger/OpenAPI interaction:

ToolFunction
swagger_select_serviceConnect to a service
swagger_list_servicesList configured services
swagger_get_currentGet current service info
swagger_list_endpointsList API endpoints
swagger_get_endpointGet endpoint details
swagger_searchSearch endpoints
swagger_get_schemaGet schema structure
swagger_list_schemasList all schemas
swagger_testExecute HTTP request
swagger_curlGenerate cURL command

See Also

Released under the MIT License.