Стартовый шаблон для построения серверов MCP (Model Context Protocol). Этот шаблон обеспечивает чистую основу для создания собственного MCP-сервера, который может интегрироваться с Claude Desktop, Cursor, Claude Code, Gemini и другими MCP-совместимыми помощниками ИИ.

##Цель

Этот шаблон помогает быстро начать строительство:

Пользовательские инструменты для AI-помощников Поставщики ресурсов для динамического контента Быстрые шаблоны для общих операций Точки интеграции для внешних API и сервисов

Особенности

Два примера инструментов: «hello-world» и «get-mcp-docs» Поддержка TypeScript с целевыми модулями ES2022 и ES

• Многоклиентские скрипты установки (Claude Desktop, Cursor, Claude Code, Gemini и др.) Автоматический рабочий процесс публикации npm Поддержка переменной среды через .env.local Чистая структура проекта с проверкой Zod

Как это работает

Этот шаблон сервера MCP обеспечивает:

1. Базовая настройка сервера с использованием MCP SDK
2. пример реализации инструмента 3.Скрипты построения и установки 4.Конфигурация TypeScript для разработки

Включенный пример демонстрирует, как создать простой инструмент, который берет параметр имени и возвращает приветствие.

Начало работы

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 Desktop, Cursor, Claude Code, Gemini, and 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

• Two example tools: “hello-world” and “get-mcp-docs”
• TypeScript support with ES2022 target and ES modules
• Multi-client installation scripts (Claude Desktop, Cursor, Claude Code, Gemini, etc.)
• Automatic npm publishing workflow
• Environment variable support via .env.local
• Clean project structure with Zod validation

How It Works

This MCP server template provides:

1. A basic server setup using the MCP SDK
2. Example tool implementation
3. Build and installation scripts
4. 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

Option 1: Use the Published Package (Recommended)

You can use this MCP server directly without cloning:

# Run the server directly with npx
npx @r-mcp/boilerplate

Option 2: Customize and Develop

# Clone the boilerplate
git clone 
cd mcp-server-boilerplate

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Start the server
pnpm start

Installation Scripts

This boilerplate includes convenient installation scripts for different MCP clients:

# Install to all MCP clients (Claude Desktop, Cursor, Claude Code, Gemini, MCP)
pnpm run install-server

# Install to specific clients
pnpm run install-desktop       # Claude Desktop
pnpm run install-cursor        # Cursor IDE
pnpm run install-code          # Claude Code CLI
pnpm run install-code-library  # Claude Code Library (~/.claude/mcp-library/)
pnpm run install-mcp           # Local .mcp.json for development

# You can also combine multiple targets:
node scripts/update-config.js cursor code desktop

These scripts will:

• Build the project automatically (TypeScript compilation + chmod permissions)
• Configure clients to use npx @r-mcp/@latest (auto-updating)
• Only the local .mcp.json uses the development version (node dist/index.js)
• Include environment variables from .env.local if present

Publishing Your Server

To publish your customized MCP server:

# Build, commit, and publish to npm in one command
pnpm run release

This script (scripts/build-and-publish.js) will:

1. Commit any pending changes first
2. Update package name to @r-mcp/
3. Update bin name to match directory
4. Increment patch version automatically
5. Build the TypeScript project
6. Commit version bump to git