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 自主开发，人类负责账号运营和商业决策。