mcp-server-builder

Generate MCP server manifests and starter code from OpenAPI specs.

Updated Nov 28, 2025
One-click install
npx skills add https://github.com/moshesham/Economic-Dashboard-API --skill mcp-server-builder-moshesham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-server-builder
Source: https://github.com/moshesham/Economic-Dashboard-API/tree/main/.github/skills/mcp-server-builder
Command: npx skills add https://github.com/moshesham/Economic-Dashboard-API --skill mcp-server-builder-moshesham

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Automate the scaffolding and governance of MCP servers built from API contracts, reducing boilerplate and ensuring consistency, versioning, and safety across Python and TypeScript runtimes.

Core Features & Use Cases

  • Convert OpenAPI specs into MCP manifests and starter server code for Python or TypeScript.
  • Enforce naming, descriptions, and schema consistency to prevent production issues.
  • Apply backward-compatible versioning and provide changelogs for contract evolution.
  • Separate transport/runtime decisions from tool contract design to support multiple deployments.

Quick Start

Start from a valid OpenAPI spec and run the MCP scaffold tool to generate a manifest and starter server code in your chosen language.

Frequently Asked Questions about mcp-server-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an MCP server from an OpenAPI spec?

To scaffold an MCP server from an OpenAPI spec, provide a valid contract to generate manifests and starter code. This approach uses the spec as the source of truth to automate boilerplate creation for Python or TypeScript runtimes.

What is the best way to maintain versioning when building MCP servers?

The best way to maintain versioning for MCP servers is to apply backward-compatible versioning from the API contract. This separates transport decisions from tool contracts and provides changelogs to track contract evolution across deployments.

Can I scaffold MCP servers for both Python and TypeScript from the same OpenAPI contract?

Yes, you can scaffold MCP servers for both Python and TypeScript from the same OpenAPI contract. The scaffolding process supports both runtimes, generating language-specific starter code while maintaining consistent manifests and schema validation.

Does MCP server scaffolding enforce naming hygiene and manifest validation?

Yes, MCP server scaffolding enforces naming hygiene and manifest validation by applying safety guards during generation. This prevents production issues by ensuring descriptions, naming, and schemas remain consistent with the source OpenAPI contract.

Why should I separate runtime decisions from tool contracts when scaffolding an MCP server?

Separating runtime decisions from tool contracts when scaffolding an MCP server ensures that transport configurations remain independent of tool logic. This separation supports multiple deployment targets without altering the underlying API contract definitions.

What are the limitations of generating MCP server code from OpenAPI specifications?

Generating MCP server code from OpenAPI specifications relies entirely on the accuracy of the source contract. If the input spec lacks proper descriptions or valid schemas, the generated manifests and starter code will inherit those structural inconsistencies.