MCP (모델 Context Protocol) 서버를 구축하기위한 스타터 템플릿. 이 보일러판은 Claude Desktop, Cursor, Claude Code, Gemini 및 기타 MCP 호환 AI 조수와 통합 할 수있는 자체 MCP 서버를 만드는 깨끗한 기반을 제공합니다.

목적

이 보일러판은 신속하게 건물을 시작합니다:

• AI Assistants에 대한 사용자 정의 도구
• 동적 콘텐츠에 대한 리소스 제공
• 일반적인 작업을위한 Prompt 템플릿
• 외부 API 및 서비스의 통합점

특징

• 두 가지 예 도구 : "hello-world"및 “get-mcp-docs”
• ES2022 대상 및 ES 모듈과 TypeScript 지원
• 멀티클라이언트 설치 스크립트(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