OpenAPI Schema Explorer

OpenAPI Schema Explorer

Token-efficient access to local or remote OpenAPI/Swagger specs via MCP Resources.

61
Stars
8
Forks
7
Releases

Overview

An MCP (Model Context Protocol) server that provides token-efficient access to OpenAPI v3.0 and Swagger v2.0 specifications via MCP Resources. The server can load specs from local file paths or HTTP/HTTPS URLs and automatically convert Swagger v2.0 to OpenAPI v3.0 on load. It exposes a set of MCP Resource templates designed for read-only exploration, allowing clients to browse top-level fields, paths, operations, and components using intuitive URIs such as openapi://info, openapi://paths/{path}, and openapi://components/{type}. The server supports multiple output formats (JSON by default, YAML, or minified JSON) and keeps token usage low by presenting structured slices of the spec instead of the entire document. The dynamic server name in MCP clients reflects the spec's info.title, and internal $ref references are transformed into clickable MCP URIs for easier navigation. It is intended for use by MCP clients like Claude Desktop, Cline, and Windsurf to explore large specifications without loading them fully into context.

Details

Owner
kadykov
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

MCP Resource Access

Explore OpenAPI specs via intuitive MCP URIs (e.g., openapi://info, openapi://paths/...); read-only access designed for MCP clients.

OpenAPI v3.0 & Swagger v2.0 Support

Loads both formats and automatically converts Swagger v2.0 to OpenAPI v3.0 on load.

Local & Remote Files

Supports loading specs from local file paths or HTTP/HTTPS URLs.

Token-Efficient

Minimizes token usage for LLMs by presenting structured views rather than entire documents.

Multiple Output Formats

Returns detailed views in JSON (default), YAML, or minified JSON via --output-format.

Dynamic Server Name

Server name in MCP clients reflects the info.title of the loaded spec.

Reference Transformation

Transforms internal $ref references (e.g., #/components/...) into clickable MCP URIs for easier navigation.

Audience

MCP ClientsExplore large OpenAPI specs without loading entire documents into LLM context.
DevelopersIntegrate token-efficient access into MCP-enabled workflows for API exploration and quick inspection.

Tags

MCPOpenAPISwaggerResourcesToken-efficientLocal and RemoteOpenAPI v3.0Swagger v2.0