skills.rest
reason-machines
reason-machinesOFFICIAL
Explore all skills by this author →
Website𝕏@reasonmachinesGitHub

mcp-quickstart-scaffolder

Scaffold, test, and deploy MCP servers in TypeScript or Python from OpenAPI specs or curl commands.

7|2|Updated May 16, 2026
Search Tags:#typescript#API integration#openapi#code generation#scaffolding#MCP#cloudflare workers
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill mcp-quickstart-scaffolder-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-quickstart-scaffolder
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/mcp-quickstart-scaffolder
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill mcp-quickstart-scaffolder-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building a Model Context Protocol server from scratch involves repetitive boilerplate: server setup, tool registration, transport configuration, tests, and deployment wiring. This Skill generates a complete, testable MCP server project in seconds so developers can focus on business logic instead of scaffolding. ## Core Features & Use Cases - Multi-language scaffolding: Generate MCP servers in TypeScript or Python with stdio, HTTP, or Cloudflare Workers transports, including example tools, resources, prompts, and passing unit tests. - OpenAPI and curl import: Automatically convert an OpenAPI 3.x spec or a single curl command into MCP tools with generated zod schemas, an HTTP client, and environment-based auth configuration. - Cloudflare Workers deployment: Scaffold an edge-deployable remote MCP server and deploy it with wrangler in one workflow. - Use Case: You have a REST API documented with an OpenAPI spec. Run the generator with --from-openapi and --transport cloudflare to produce an API-backed MCP server, set your API key as a wrangler secret, and deploy it to a public /mcp endpoint usable by Claude Desktop or Cursor. ## Quick Start Ask the AI to scaffold a new TypeScript MCP server from your OpenAPI spec URL and deploy it to Cloudflare Workers.

Frequently Asked Questions about mcp-quickstart-scaffolder

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

FAQPage Schema
How do I create a new MCP server quickly?▼

Run npm create mcp-quickstart@latest for interactive scaffolding, or pass flags like --lang ts --transport stdio -y for non-interactive generation. The generated project includes example tools, resources, prompts, and passing unit tests out of the box.

How to generate MCP tools from an OpenAPI spec?▼

Use the --from-openapi flag with a URL or local file path, for example npx mcp-quickstart petstore-mcp --from-openapi https://petstore3.swagger.io/api/v3/openapi.json. The generator creates one MCP tool per API operation with zod schemas and a generic HTTP client.

Can I deploy an MCP server to Cloudflare Workers?▼

Yes, scaffold with --transport cloudflare, then run npm install, npx wrangler login, and npm run deploy. The server is published to a workers.dev /mcp endpoint, and API keys are configured via wrangler secrets.

Does mcp-quickstart support Python MCP servers?▼

Yes, pass --lang python to generate a Python stdio server. The project uses uv for dependency management, uv run to start the server, and uv run pytest to execute tests.

Why does OpenAPI generation fail for my spec?▼

Generation fails when the spec is not valid OpenAPI 3.x, contains unresolvable $ref paths, or the remote URL is not publicly accessible. Validate the spec at editor.swagger.io before running the generator.

How do I turn a curl command into an MCP tool?▼

Pass the command with --from-curl, either as a string or a file path. The generator parses the URL, query parameters, and headers into a typed MCP tool with an .env.example containing API_BASE_URL, API_AUTH_HEADER, and API_AUTH_VALUE.

Related Skills

Explore More Software Engineering Skills→
gitgoodordietryinggitgoodordietrying
1

api-dev

Scaffold and validate REST and GraphQL APIs from the command line.

Community
Advanced
shaprisshapris

configuring-dbt-mcp-server

Generate dbt MCP server configuration JSON and validate connectivity.

Community
Advanced
sathishssj3sathishssj3
2

mcp-server-builder

Creates Model Context Protocol servers with tools, resources, and prompts for Claude.

Community
Intermediate
modelcontextprotocolmodelcontextprotocol
2.7k

add-app-to-server

Add interactive MCP Apps UI to existing MCP server tools.

Official
Intermediate