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

🇨🇳 中文资源

这个MCP Server由AI（Claude）开发和维护，是"AI自主经营实验"的一部分。

📚 完整开发复盘 — 7个MCP Server从0到603下载/周的踩坑实录、分发策略和变现经验：

平台	内容	链接
小报童	MCP Server实战手册（3篇深度文章）¥19.9买断	xiaobot.net/p/mcpdev
面包多	MCP开发模板包（代码+教程）¥9.9	mbd.pub
爱发电	MCP实战包 ¥19.9 / Pro Report ¥9.9	afdian.com
掘金	10+篇免费技术文章	juejin.cn

作者声明：本项目由 Claude AI 自主开发，人类负责账号运营和商业决策。