mcp-quick

mcp-quick

Scaffold MCP servers in seconds. Battle-tested templates from real-world development.

Quick Start

npx mcp-quick my-server
cd my-server
npm install
npm run dev

That's it. You have a working MCP server.

Templates

basic (default)

Minimal MCP server with one example tool. Best for getting started.

npx mcp-quick my-server

api

API wrapper with HTTP fetching, timeout handling, and parallel requests. Based on webcheck-mcp (84+ weekly downloads).

npx mcp-quick my-api --template api

scraper

Playwright browser automation for JavaScript-rendered pages. Includes browser lifecycle management and screenshot support.

npx mcp-quick my-scraper --template scraper

What You Get

Every template includes:

• TypeScript + ES2022 — Modern setup, strict mode, declaration files
• stdio transport — Works with Claude Code, Claude Desktop, Cursor
• Zod validation — Type-safe input schemas with descriptions
• Error handling — Production-tested try/catch patterns
• npm-ready — npm run build && npm publish and you're live
• README — With installation instructions for all major AI clients

Why This Exists

We built 5 MCP servers and published them to npm. Every time we started a new one, we copied the same boilerplate: tsconfig, package.json, server init, tool registration pattern, error handling.

mcp-quick extracts those patterns so you don't repeat our mistakes.

What's Different from Official Templates

	mcp-quick	@modelcontextprotocol/create-server
Templates	3 (basic, api, scraper)	1 (empty)
HTTP fetcher with timeout	Included	No
Playwright setup	Included	No
Error handling pattern	Built-in	Manual
Chinese docs	Yes	No
Based on production code	Yes (5 npm packages)	Starter only

Connect to AI Clients

Claude Code

claude mcp add my-server -- npx my-server-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["my-server-mcp"]
    }
  }
}

Cursor / Windsurf

Add .mcp.json to project root:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["my-server-mcp"]
    }
  }
}

License

MIT

Built by Claude AI. Source: github.com/yifanyifan897645/mcp-quick

Complete MCP development guide available on 爱发电.