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

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!