dynamic-openapi-tools

Shared building blocks for the dynamic-openapi-{cli,mcp,skill} family.

What's inside

Module	Exports	Used by
dynamic-openapi-tools/parser	loadSpec, resolveSpec, filterOperations, resolveSource, types (ParsedSpec, ParsedOperation, ...)	cli, mcp, skill
dynamic-openapi-tools/auth	resolveAuth, BearerAuth, ApiKeyAuth, BasicAuth, OAuth2ClientCredentials, TokenExchangeAuth, CustomAuth, CompositeAuth	cli, mcp
dynamic-openapi-tools/bundle	buildBundle, renderBundleShim (parameterized bash shim generator for standalone binaries)	cli, mcp
dynamic-openapi-tools/utils	fetchWithRetry, sanitizeToolName, truncateDescription	cli, mcp

The root entry (dynamic-openapi-tools) re-exports everything.

Install

pnpm add dynamic-openapi-tools

Bundle example

The bundle module is parameterized — each consumer passes the runnerPackage (npm package name to exec at runtime), kindLabel (variable prefix in the generated shim), and a bash runnerInvocation snippet describing how to invoke the runner once the spec has been decoded to $SPEC_FILE.

import { buildBundle } from 'dynamic-openapi-tools/bundle'

// MCP-style bundle: runner receives --source
await buildBundle({
  source: './petstore.yaml',
  name: 'petstore-mcp',
  out: './bin/petstore-mcp',
  runnerPackage: 'dynamic-openapi-mcp',
  kindLabel: 'MCP',
  runnerInvocation: '--source "$SPEC_FILE" "${PASSTHROUGH[@]}"',
  installSuccessHint: 'Point your MCP client at:  %s',
})

// CLI-style bundle: runner also receives --name and --app-version
await buildBundle({
  source: './petstore.yaml',
  name: 'petstore-cli',
  out: './bin/petstore-cli',
  runnerPackage: 'dynamic-openapi-cli',
  kindLabel: 'CLI',
  runnerInvocation:
    '--spec "$SPEC_FILE" --name "$CLI_NAME" --app-version "$CLI_VERSION" "${PASSTHROUGH[@]}"',
  installSuccessHint: 'Run:  %s --help',
})

Generated shims expose --show-spec, --spec-md5, --spec <override>, install, uninstall, and update — regardless of the runner.

The family

Package	Role
dynamic-openapi-cli	Generic CLI for any OpenAPI spec
dynamic-openapi-mcp	MCP server for any OpenAPI spec
dynamic-openapi-skill	Claude Code skill generator for any OpenAPI spec

License

MIT