MCP Server Boilerplate

What is MCP Server Boilerplate?

MCP Server Boilerplate is a starter implementation of a server following the Model Context Protocol (MCP), built with TypeScript and Express. It provides sample resources, tools, and prompts to help developers quickly build MCP-compatible servers that supply context to LLMs in a standardized way.

How to use MCP Server Boilerplate?

Clone the repository, install dependencies (npm install), copy .env.example to .env, and configure environment variables like PORT. Run the HTTP server with npm start or npm run dev for development. For command-line tools, use npm run start:stdio or npm run dev:stdio.

Key features of MCP Server Boilerplate

• Built with TypeScript and Express for HTTP transport
• Includes sample resources, tools, and prompts
• Supports both HTTP and stdio transport modes
• Easy extension via modular resource/tool/prompt files
• Uses the official MCP TypeScript SDK

Use cases of MCP Server Boilerplate

• Rapidly prototype a new MCP server for LLM context
• Learn how to implement resources, tools, and prompts with MCP
• Serve as a foundation for production MCP servers
• Test and debug MCP implementations using the Inspector tool

FAQ from MCP Server Boilerplate

What are the prerequisites to run MCP Server Boilerplate?

Node.js v18 or later and npm or yarn are required.

How do I start the server?

Build the project with npm run build, then run npm start for HTTP mode or npm run start:stdio for stdio mode. For development with auto-restart, use npm run dev or npm run dev:stdio.

Can I add my own resources, tools, or prompts?

Yes. Create a new file in the respective src/resources/, src/tools/, or src/prompts/ directory, implement the handler, and register it in the corresponding index.ts file. The README provides code examples for each.

What transport modes are supported?

HTTP (via Express on a configurable port) and stdio (for command-line integration) are both supported.

Is there a license for this project?

Yes, the project is licensed under the MIT License.