Offers complete TypeScript support with proper type definitions for building MCP servers with type safety.
Utilizes Zod for schema validation of tool parameters, enabling strong typing and validation for inputs to custom tools and prompts.
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 compile - Test your server with
pnpm start
- Use the installation scripts to update your MCP client configuration
Next Steps
- Update
package.json
with your project details - Customize 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
This server cannot be installed
A starter template for building Model Context Protocol servers that integrate with AI assistants like Claude and Cursor, providing custom tools, resource providers, and prompt templates.
Related MCP Servers
- AsecurityFlicenseAqualityA starter template for building Model Context Protocol servers that can be integrated with Cursor or Claude Desktop, allowing developers to create custom tools and extensions for AI assistants.Last updated -11513TypeScript
- -securityAlicense-qualityA template for building Model Context Protocol servers that allow AI assistants to interact with custom data and services through queryable resources and specialized tools.Last updated -TypeScriptMIT License
- -securityFlicense-qualityA starter template for building Model Context Protocol servers that can integrate AI assistants with custom tools, resource providers, and prompt templates.Last updated -JavaScript
- -securityFlicense-qualityA starter template for building Model Context Protocol servers that integrate with AI assistants like Claude and Cursor, providing custom tools, resource providers, and prompt templates.Last updated -JavaScript