openapi-to-MCP

Dereference the OpenAPI or Swagger document into a single JSON object on disk before mapping operations.
Map OpenAPI parameters and request bodies to a merged Zod object schema for the MCP tool definition.

Transport must be streamable HTTP, not stdio.
OpenAPI circular references are kept as-is and must be treated as opaque object types in Zod.
Verify that the correct scaffold template was chosen: `--template mcp-apps` if any widgets are needed, otherwise `--template blank`.
Search the dereferenced specification file to confirm there are no remaining `$ref` pointers.
Ensure authentication secrets are read from environment variables and are never placed directly in the conversation or committed to the repository.

AI 搜索