MCP Boilerplate

MCP Banner

🚀 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 found

quality - not tested

How are these scores calculated?

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
coinselor
A
security
A
license
A
quality
A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
Last updated -
1
57
MIT License
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
57
4
MIT License
mcp-framework-starter
QuantGeekDev
-
security
F
license
-
quality
A starter template for building Model Context Protocol (MCP) servers, enabling developers to create and add custom tools that can be integrated with Claude Desktop.
Last updated -
2
MCP TypeScript Starter
yhwancha
-
security
F
license
-
quality
A starter template for creating Model Context Protocol servers using TypeScript, providing basic setup and sample tool implementation for developers to build their own MCP servers.
Last updated -

View all related MCP servers

Appeared in Searches

Creating an MCP server with API integration