mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-09-06 08:15:58 +00:00

History

Claude 1b6d330704 refactor(skills): trim mcp-server-builder to 100 lines exactly (ceiling inclusive) https://claude.ai/code/session_01CUWsrUNZP9jpxvAwq67UiT		2026-06-11 18:24:31 +00:00
..
references	refactor(skills): #655 Phase-1 pilot — ci-cd-pipeline-builder + mcp-server-builder under 100-line ceiling	2026-06-11 18:18:40 +00:00
scripts	fix(plugins): restructure 9 multi-skill domain plugins into ./skills/ layout	2026-05-02 22:51:20 +02:00
README.md	fix(plugins): restructure 9 multi-skill domain plugins into ./skills/ layout	2026-05-02 22:51:20 +02:00
SKILL.md	refactor(skills): trim mcp-server-builder to 100 lines exactly (ceiling inclusive)	2026-06-11 18:24:31 +00:00

README.md

MCP Server Builder

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