A
securityA
licenseA
qualityA 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
59
MIT License
Runs the MCP server with Bun's high-performance JavaScript runtime for improved speed and efficiency
Uses Express 5.x server for handling HTTP requests and routing in the MCP implementation
Provides Node.js support as an alternative runtime environment for the MCP server
Implements the server with TypeScript for type safety and modern language features
Incorporates Zod schemas for robust data validation of MCP requests and responses
🚀 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
Package manager (
bun,npm,pnpm, oryarn)
⚡ 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 |
| Start dev server with hot reload |
| Compile TypeScript |
| 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 > MCPAdd a new MCP server
+ Add new global MCP serverPaste 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
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
- AsecurityAlicenseAqualityA 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 -1594MIT License
- -securityFlicense-qualityA 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
- -securityFlicense-qualityA 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.