PF

punkpeye/fastmcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

3,3 тыс. stars 336 forks Качество 90 Тренд 48MIT

Фреймворк TypeScript для построения MCP-серверов.

Обзор

Фреймворк TypeScript для создания MCP-серверов, способных обрабатывать клиентские сессии. Для реализации на Python см. FastMCP. FastMCP построен на основе официального SDK. Официальный SDK содержит базовые блоки для создания MCP, но оставляет вам множество деталей реализации: - Инициация и настройка всех компонентов сервера - Обработка соединений - Обработка инструментов - Обработка ответов - Обработка ресурсов - Добавление подсказок, ресурсов, шаблонов ресурсов - Встраивание ресурсов, блоков изображений и аудиоконтента FastMCP устраняет эту сложность, предоставляя мнений фреймворк, который: - Автоматически обрабатывает все шаблонные элементы - Предоставляет простые, интуитивно понятные API для обычных задач - Включает встроенные лучшие практики и обработку ошибок - Позволяет сосредоточиться на основной функциональности вашего MCP Вы хотите быстро строить MCP-серверы, не сталкиваясь с низкоуровневыми деталями реализации.

Обзор (машинный перевод)

Фреймворк TypeScript для создания MCP-серверов, способных обрабатывать клиентские сессии.

[! ВАЖНО]

FastMCP реализует устаревшие версии MCP на основе рукопожатия (2025-11-25 и более ранние). Она не поддерживает текущую спецификацию 2026-07-28, которая делала протокол безсостоятельным — без initialize рукопожатия и без Mcp-Session-Id. Для фреймворка, ориентированного на текущую спецификацию, используйте ViteMCP.

Особенности

  • Простое определение инструмента, ресурса и запросов
  • Преобразование OpenAPI в MCP
  • Аутентификация
  • Передача заголовков через контекст
  • Отслеживание идентификаторов сессии и идентификатора запроса
  • Сессии
  • Содержимое изображений
  • Аудиоконтент
  • Встроенные
  • Лесозаготовка
  • Обработка ошибок
  • HTTP-потоковая передача (с совместимостью с SSE)
  • Поддержка HTTPS для безопасных соединений
  • Пользовательские HTTP-маршруты для REST API, вебхуков и административных интерфейсов
  • Поддержка Edge Runtime для Cloudflare-работников, Deno Deployment и многое другое
  • Режим без состояния для безсерверных развертываний
  • CORS (включен по умолчанию)
  • Уведомления о прогрессе
  • Потоковый выход
  • Типизированные события сервера
  • Автозаполнение аргумента prompt
  • Выборка
  • Elicitation
  • Настраиваемое поведение пинга
  • Конечная точка проверки здоровья
  • Корни
  • Транспорт в памяти для модульного тестирования без привязки порта

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

FastMCP

A TypeScript framework for building MCP servers capable of handling client sessions.

[!IMPORTANT]

FastMCP implements the legacy, handshake-based MCP revisions (2025-11-25 and earlier). It does not support the current specification, 2026-07-28, which made the protocol stateless — no initialize handshake and no Mcp-Session-Id. For a framework targeting the current spec, use ViteMCP.

Features

When to use FastMCP over the official SDK?

FastMCP is built on top of the official SDK.

The official SDK provides foundational blocks for building MCPs, but leaves many implementation details to you:

Открыть полный README на GitHub

Установка

npx tsx /PATH/TO/YOUR_PROJECT/src/index.ts
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "my-mcp-server": { "command": "npx", "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"], "env": { "YOUR_ENV_VAR": "value" } } } }