MCP-Framework — это фреймворк для элегантного построения серверов Model Context Protocol (MCP) в TypeScript.

MCP-Framework предоставляет архитектуру из коробки с автоматическим поиском инструментов, ресурсов и подсказок на основе каталогов. Используйте наши мощные абстракции MCP для элегантного определения инструментов, ресурсов или подсказок. Наш CLU делает начало работы с вашим собственным MCP-сервером очень простым

Особенности

• 🛠️ Автоматическое обнаружение и загрузка инструментов, ресурсов и подсказок
• Поддержка множественного транспорта (stdio, SSE, HTTP Stream)
• Разработка на основе TypeScript с полной безопасностью шрифта
• Построен на официальном SDK MCP
• Простые в использовании базовые классы для инструментов, подсказок и ресурсов
• Готовая аутентификация для конечных точек SSE (OAuth 2.1, JWT, API Key)

Проекты, созданные с использованием фреймворка 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