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
};
}
};
License
ISC