Back to Projects
ai
2026

create-mcp-server — Scaffold an MCP Server in 30 Seconds

create-mcp-server is the `create-next-app` of MCP. `npm create mcp-server@latest` walks you through naming and template selection, then writes a complete TypeScript MCP server — package.json with the right SDK version pinned, tsconfig set up for stdio servers, src/index.ts with at least one working tool, README, and gitignore. Two templates ship in v0.1: `blank` (one example tool, your starting point for custom tools) and `markdown-rag` (exposes a ./content/ directory of markdown as MCP resources with a keyword search tool). Zero runtime dependencies in the CLI itself — pure Node + readline. Companion to the portfolio MCP server and the MCP Inspector demo, written to onboard other engineers into the MCP ecosystem.

create-mcp-server — Scaffold an MCP Server in 30 Seconds
Technologies

Frontend

Backend

TypeScript
Node.js (readline)
@modelcontextprotocol/sdk

Database

Tools

tsx
gray-matter (markdown-rag template)
stdio transport
Challenges
  • Going from 'I want to build an MCP server' to a runnable hello-world is a 30-minute boilerplate exercise the first time
  • Each MCP client (Claude Desktop, Cursor, Cline, Zed) needs the same config snippet — generating it correctly is fiddly
  • Common patterns (RAG over a markdown dir, wrapping an API) recur, so each engineer reinvents the same scaffolding
Solutions
  • Interactive Node + readline CLI with two starter templates: minimal (one tool) and markdown-RAG (resources + keyword search)
  • Auto-generated Claude Desktop config snippet with the absolute path pre-filled — paste it and you're done
  • Zero runtime dependencies in the CLI; templates pin @modelcontextprotocol/sdk and ship a working build pipeline (tsc → dist/)
Key Outcomes & Impact

Working MCP server scaffolded in under a minute, regardless of template chosen

Two production-shaped templates that onboard engineers into both 'blank canvas' and 'RAG over docs' patterns

Reusable scaffolder pattern: new templates require only a new ./templates/<name>/ directory

Other Projects

Multi-Agent PR Reviewer
Multi-Agent PR Reviewer

Paste any public GitHub PR — four specialised AI agents review it in parallel (correctness, security, style, tests), a lead reviewer synthesises a severity-graded verdict.

View Project
JobJam.io — AI Job Search & Application Platform
JobJam.io — AI Job Search & Application Platform

AI-powered job search platform: discover roles, evaluate fit, tailor applications, and close skill gaps. One-time pricing, no subscriptions.

View Project