MCP Server Boilerplate
A starter template for building MCP (Model Context Protocol) servers. This boilerplate provides a clean foundation for creating your own MCP server that can integrate with Claude, Cursor, or other MCP-compatible AI assistants.
Purpose
This boilerplate helps you quickly start building:
Custom tools for AI assistants
Resource providers for dynamic content
Prompt templates for common operations
Integration points for external APIs and services
Features
Simple "hello-world" tool example
TypeScript support with proper type definitions
Easy installation scripts for different MCP clients
Clean project structure ready for customization
How It Works
This MCP server template provides:
A basic server setup using the MCP SDK
Example tool implementation
Build and installation scripts
TypeScript configuration for development
The included example demonstrates how to create a simple tool that takes a name parameter and returns a greeting.
Getting Started
Installation Scripts
This boilerplate includes convenient installation scripts for different MCP clients:
These scripts will build the project and automatically update the appropriate configuration files.
Usage with Claude Desktop
The installation script will automatically add the configuration, but you can also manually add it to your claude_desktop_config.json
file:
Then restart Claude Desktop to connect to the server.
Customizing Your Server
Adding Tools
Tools are functions that the AI assistant can call. Here's the basic structure:
Adding Resources
Resources provide dynamic content that the AI can access:
Adding Prompts
Prompts are reusable templates:
Project Structure
Development
Make changes to
src/index.ts
Run
pnpm run build
to compileTest your server with
pnpm start
Use the installation scripts to update your MCP client configuration
Next Steps
Update
package.json
with your project detailsCustomize the server name and tools in
src/index.ts
Add your own tools, resources, and prompts
Integrate with external APIs or databases as needed
License
MIT
A starter template for building MCP (Model Context Protocol) servers with TypeScript support. Provides a clean foundation with example tools, resources, and prompts for creating custom integrations with Claude, Cursor, or other MCP-compatible AI assistants.