oas2mcp.normalize

Normalization helpers for oas2mcp.

Purpose:

Convert parsed OpenAPI specifications into stable internal Pydantic models.

Design:

  • Keep normalization logic separate from loading and rendering.

  • Accept either LangChain OpenAPISpec objects or dumped spec dictionaries.

  • Produce ApiCatalog objects that are easy to inspect, enrich, and eventually transform into MCP-oriented structures.

oas2mcp.normalize.__all__[source][source]

Curated public exports for normalization helpers.

Examples

from oas2mcp.normalize import openapi_spec_to_catalog
from oas2mcp.loaders import load_openapi_spec_from_url

spec = load_openapi_spec_from_url(
    "https://petstore3.swagger.io/api/v3/openapi.json",
)
catalog = openapi_spec_to_catalog(
    spec,
    source_uri="https://petstore3.swagger.io/api/v3/openapi.json",
)

Submodules