MCP-프레임워크는 TypeScript에서 모델 컨텍스트 프로토콜(MCP) 서버를 우아하게 구축할 수 있는 프레임워크입니다.

MCP-프레임워크는 도구, 리소스, 프롬프트에 대한 자동 디렉터리 기반 발견과 함께 기본 아키텍처를 제공합니다. 강력한 MCP 추상화를 활용해 도구, 리소스, 프롬프트를 우아하게 정의하세요. 저희 CLI 덕분에 자신만의 MCP 서버를 시작하는 것이 매우 수월합니다

특징

• 🛠️ 도구, 리소스, 프롬프트의 자동 발견 및 로드
• 다중 전송 지원(stdio, SSE, HTTP 스트림)
• TypeScript - 완전한 타입 안전성 기반 개발로
• 공식 MCP SDK를 기반으로 구축됨
• 도구, 프롬프트, 리소스를 위한 사용하기 쉬운 기본 클래스
• SSE 엔드포인트용 기본 인증 (OAuth 2.1, JWT, API 키)

MCP 프레임워크로 구축된 프로젝트

다음 프로젝트와 서비스는 MCP 프레임워크를 사용하여 구축되었습니다:

• tip.md

AI 비서가 채팅 인터페이스를 통해 콘텐츠 제작자에게 직접 암호화폐 팁을 보낼 수 있도록 돕는 암호화폐 팁 서비스입니다. MCP 서비스는 다음과 같은 기능을 제공합니다:

• 사용자의 지갑 유형 확인
• 사용자/에이전트가 작성할 암호화폐 팁 준비

MCP Framework

MCP-Framework is a framework for building Model Context Protocol (MCP) servers elegantly in TypeScript.

MCP-Framework gives you architecture out of the box, with automatic directory-based discovery for tools, resources, and prompts. Use our powerful MCP abstractions to define tools, resources, or prompts in an elegant way. Our cli makes getting started with your own MCP server a breeze

Features

• 🛠️ Automatic discovery and loading of tools, resources, and prompts
• Multiple transport support (stdio, SSE, HTTP Stream)
• TypeScript-first development with full type safety
• Built on the official MCP SDK
• Easy-to-use base classes for tools, prompts, and resources
• Out of the box authentication for SSE endpoints (OAuth 2.1, JWT, API Key)

Projects Built with MCP Framework

The following projects and services are built using MCP Framework:

• tip.md

A crypto tipping service that enables AI assistants to help users send cryptocurrency tips to content creators directly from their chat interface. The MCP service allows for:

• Checking wallet types for users
• Preparing cryptocurrency tips for users/agents to complete Setup instructions for various clients (Cursor, Sage, Claude Desktop) are available in their MCP Server documentation.

Support our work

Read the full docs here

Creating a repository with mcp-framework

Using the CLI (Recommended)

# Install the framework globally
npm install -g mcp-framework

# Create a new MCP server project
mcp create my-mcp-server

# Navigate to your project
cd my-mcp-server

# Your server is ready to use!

CLI Usage

The framework provides a powerful CLI for managing your MCP server projects:

Project Creation

# Create a new project
mcp create 

# Create a new project with the new EXPERIMENTAL HTTP transport
Heads up: This will set cors allowed origin to "*", modify it in the index if you wish
mcp create  --http --port 1337 --cors

Options:

–http: Use HTTP transport instead of default stdio

–port : Specify HTTP port (default: 8080)

–cors: Enable CORS with wildcard (*) access

Adding a Tool

# Add a new tool
mcp add tool price-fetcher

Building and Validation

The framework provides comprehensive validation to ensure your tools are properly documented and functional:

# Build with automatic validation (recommended)
npm run build

# Build with custom validation settings
MCP_SKIP_TOOL_VALIDATION=false npm run build  # Force validation (default)
MCP_SKIP_TOOL_VALIDATION=true npm run build   # Skip validation (not recommended)

Validating Tools

# Validate all tools have proper descriptions (for Zod schemas)
mcp validate