🚀 MCP Boilerplate

Powered by Bun ⚡

A modern, lightning-fast boilerplate for Model Context Protocol (MCP) applications

🔥 Features

• Blazing-fast MCP with Bun

• Modern TypeScript-first architecture

• MCP SDK integration out-of-the-box (@modelcontextprotocol/sdk)

• Express 5.x server with proper TypeScript support

• Robust validation using Zod schemas

• Smart logging with Morgan

• Environment configuration support

• CLI-ready implementation

Related MCP server: MCP Server Starter (TypeScript)

🛠️ Prerequisites

• Bun 1.0+ or Node.js 20+

• Package manager (bun, npm, pnpm, or yarn)

⚡ Quick Start

# Clone repository
git clone https://github.com/jhon2c/mcp-boilerplate.git
cd mcp-boilerplate

# Install dependencies (with Bun) [Recommended]
bun install

# OR with npm
npm install

# Start development server
bun run dev

🚄 Development Scripts

🌐 Environment Setup

Create .env file:

PORT=3000 
MCP_API_KEY=your_api_key_here
DEBUG=mcp:*

✨ Setup the MCP server on Cursor

1. Install and run the server

2. Go to Cursor MCP Settings Files > Preferences > Cursor Settings > MCP

3. Add a new MCP server + Add new global MCP server

4. Paste the setup JSON

{
    "mcpServers": {
        "mcp-boilerplate": {
            "url": "http://localhost:3001/sse"
        }
    }
}

📂 Project Structure

mcp-boilerplate/
├── src/
│ ├── index.ts
│ ├── config/
│ ├── services/
│ └── types/
└── build/

📦 Key Dependencies

Runtime:

• @modelcontextprotocol/sdk

• express@5

• zod

• ky

Dev:

• tsx

🤝 Contributing Fork repo

1. Create feature branch

2. Commit changes

3. Push branch

4. Open PR

📄 License MIT - See LICENSE

Happy Coding!