MCP Server Boilerplate

A basic Model Context Protocol (MCP) server implementation that can be used as a starting point for building MCP-compatible applications.

Features

Basic MCP server setup with TypeScript
Example function implementation
Graceful shutdown handling
Development and production build configurations

Prerequisites

Node.js (v14 or higher)
npm or yarn

Installation

npm install

Development

To run the server in development mode with hot-reload:

npm run dev

Building for Production

To build the project:

npm run build

To start the production server:

npm start

Project Structure

├── src/ │ └── index.ts # Main server implementation ├── package.json # Project dependencies and scripts ├── tsconfig.json # TypeScript configuration └── README.md # This file

Adding New MCP Functions

To add new functions to the server:

Define a new function schema using Zod
Create a function implementation following the MCPFunction interface
Add the function to the server configuration

Example:

const myNewFunction: MCPFunction = { name: 'my_new_function', description: 'Description of what the function does', parameters: z.object({ // Define your parameters here }), handler: async (params) => { // Implement your function logic here return { // Return your response here }; } };