MCP Boilerplate

🚀 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

Install and run the server
Go to Cursor MCP Settings Files > Preferences > Cursor Settings > MCP
Add a new MCP server + Add new global MCP server
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:

Dev:

🤝 Contributing Fork repo

Create feature branch
Commit changes
Push branch
Open PR

📄 License MIT - See LICENSE

Happy Coding!

This server cannot be installed

security - not tested

license - not tested

quality - not tested

A modern, lightning-fast starter template for building Model Context Protocol applications with Bun, enabling developers to create MCP servers with TypeScript support, validation, and environment configuration.

Related MCP Servers

MCP Server Starter
StevenStavrakis
A
security
A
license
A
quality
A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.
Last updated -
1
7
12
JavaScript
MIT License
MCP Server Template
stevennevins
A
security
F
license
A
quality
A template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.
Last updated -
1
5
TypeScript
MCP Server Starter
GreatAuk
A
security
A
license
A
quality
A TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.
Last updated -
1
7
2
TypeScript
MIT License
MCP Framework
ronangrant
-
security
F
license
-
quality
A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
Last updated -
67
TypeScript

View all related MCP servers