🚀 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

Command	Description
bun run dev	Start dev server with hot reload
bun run build	Compile TypeScript
mcp-boilerplate	Run compiled CLI

---

🌐 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!