Generate and validate MCP servers from OpenAPI contracts with production-focused tooling. This skill helps teams bootstrap fast and enforce schema quality before shipping.

Quick Start

# Generate scaffold from OpenAPI
python3 scripts/openapi_to_mcp.py \
  --input openapi.json \
  --server-name my-mcp \
  --language python \
  --output-dir ./generated \
  --format text

# Validate generated manifest
python3 scripts/mcp_validator.py --input generated/tool_manifest.json --strict --format text

Included Tools

scripts/openapi_to_mcp.py: OpenAPI -> tool_manifest.json + starter server scaffold
scripts/mcp_validator.py: structural and quality validation for MCP tool definitions

References

references/openapi-extraction-guide.md
references/python-server-template.md
references/typescript-server-template.md
references/validation-checklist.md

Installation

Claude Code

cp -R engineering/mcp-server-builder ~/.claude/skills/mcp-server-builder

OpenAI Codex

cp -R engineering/mcp-server-builder ~/.codex/skills/mcp-server-builder

OpenClaw

cp -R engineering/mcp-server-builder ~/.openclaw/skills/mcp-server-builder