
punkpeye/fastmcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Фреймворк 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-25and earlier). It does not support the current specification,2026-07-28, which made the protocol stateless — noinitializehandshake and noMcp-Session-Id. For a framework targeting the current spec, use ViteMCP.
Features
- Simple Tool, Resource, Prompt definition
- OpenAPI to MCP conversion
- Authentication
- Passing headers through context
- Session ID and Request ID tracking
- Sessions
- Image content
- Audio content
- Embedded
- Logging
- Error handling
- HTTP Streaming (with SSE compatibility)
- HTTPS Support for secure connections
- Custom HTTP routes for REST APIs, webhooks, and admin interfaces
- Edge Runtime Support for Cloudflare Workers, Deno Deploy, and more
- Stateless mode for serverless deployments
- CORS (enabled by default)
- Progress notifications
- Streaming output
- Typed server events
- Prompt argument auto-completion
- Sampling
- Elicitation
- Configurable ping behavior
- Health-check endpoint
- Roots
- In-memory transport for unit testing without binding a port
- CLI for testing and debugging
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:
- Initiating and configuring all the server components
- Handling of connections
- Handling of tools
- Handling of responses
- Handling of resources
Установка
npx tsx /PATH/TO/YOUR_PROJECT/src/index.tsКонфигурация
{
"mcpServers": {
"my-mcp-server": {
"command": "npx",
"args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
"env": {
"YOUR_ENV_VAR": "value"
}
}
}
}