MCP Server Builder — Development

Q: How do I run the validator?

Use `python3 scripts/mcp_validator.py --input --strict --format text`.

Design and ship production-ready MCP (Model Context Protocol) servers from OpenAPI contracts instead of hand-written tool wrappers. Supports Python and TypeScript, with schema validation and safe evolution. Produces server scaffolds, tool manifests, and validation reports.

engineering claude-code

📂 View skill on GitHub ↗ 🚀 How to use

✨ What it does

Converts OpenAPI paths/operations into MCP tool definitions.
Generates starter server scaffolds in Python or TypeScript.
Enforces naming, descriptions, and schema consistency.
Validates MCP tool manifests for common production failures.
Applies versioning and backward-compatibility checks.
Separates transport/runtime decisions from tool contract design.

🎯 When to use it

Expose an internal or external REST API to an LLM agent as an MCP server.
Replace brittle browser automation with typed, contract-based tools.
Build a shared MCP server for multiple teams or assistants.
Bootstrap an MCP server from an existing OpenAPI spec.
Run repeatable quality checks before publishing MCP tools.

🚀 How to use

Trigger by asking to build an MCP server from an OpenAPI spec or to validate an MCP tool manifest. Provide an OpenAPI file (JSON) or pipe it via stdin. Use the provided scripts with options for language, server name, and output directory. Example prompts:

python3 scripts/openapi_to_mcp.py --input openapi.json --server-name billing-mcp --language python --output-dir ./out --format text

cat openapi.json | python3 scripts/openapi_to_mcp.py --server-name billing-mcp --language typescript

For validation: python3 scripts/mcp_validator.py --input out/tool_manifest.json --strict --format text

📄 Output: Produces an MCP server scaffold (code) and a tool manifest, plus optional validation reports.

📦 Add this skill to Claude Code

# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills

# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/engineering/skills/mcp-server-builder .claude/skills/mcp-server-builder

Skill source: engineering/skills/mcp-server-builder/SKILL.md

⚠️ Good to know

Requires a valid OpenAPI spec as input; the skill does not handle non-OpenAPI sources or runtime deployment.

❓ FAQ

What languages are supported for the generated server?

Python and TypeScript are supported.

How do I run the validator?

Use python3 scripts/mcp_validator.py --input <manifest> --strict --format text.

What does the validator check?

It checks for duplicate names, invalid schema shape, missing descriptions, empty required fields, and naming hygiene.

🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.