Skip to main content
Glama
jhon2c

MCP Boilerplate

by jhon2c

MCP Banner

πŸš€ MCP Boilerplate

Powered by Bun ⚑

A modern, lightning-fast boilerplate for Model Context Protocol (MCP) applications

Node.js Bun License TypeScript


πŸ”₯ 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


Related MCP server: MCP Server Starter

πŸ› οΈ Prerequisites


⚑ 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:

Dev:


🀝 Contributing Fork repo

  1. Create feature branch

  2. Commit changes

  3. Push branch

  4. Open PR

πŸ“„ License MIT - See LICENSE

Happy Coding!

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jhon2c/mcp-boilerplate'

If you have feedback or need assistance with the MCP directory API, please join our Discord server