FastMCP

Протокол контекста модели (MCP) соединяет LLM с инструментами и данными. FastMCP даёт вам всё необходимое для перехода от прототипа к продакшну:

from fastmcp import FastMCP

mcp = FastMCP("Demo 🚀")

@mcp.tool
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

if __name__ == "__main__":
    mcp.run()

Почему FastMCP

Создание эффективного MCP-приложения сложнее, чем кажется. FastMCP берёт на себя всё. Объявите инструмент с помощью Python-функции — и схема, валидация и документация будут сгенерированы автоматически. Подключитесь к серверу через URL — и согласование транспорта, аутентификация и жизненный цикл протокола будут управляться за вас. Вы сосредоточены на своей логике, а часть, связанная с MCP, просто работает: с FastMCP лучшие практики заложены из коробки.

Именно поэтому FastMCP является стандартным фреймворком для работы с MCP. FastMCP 1.0 был включён в официальный MCP Python SDK в 2024 году. Сегодня активно поддерживаемый автономный проект скачивается миллион раз в день, и какая-то версия FastMCP работает на 70% MCP-серверов на всех языках программирования.

У FastMCP три столпа:

Серверы Предоставляют инструменты, ресурсы и промпты LLM.

Приложения Предоставляют вашим инструментам интерактивные интерфейсы, отображаемые непосредственно в диалоге.

Клиенты Подключаются к любому MCP-серверу — локальному или удалённому, программному или CLI.

Серверы оборачивают ваши Python-функции в инструменты, ресурсы и промпты, соответствующие MCP. Клиенты подключаются к любому серверу с полной поддержкой протокола. А Приложения дают вашим инструментам интерактивные интерфейсы, отображаемые непосредственно в диалоге.

Готовы начать создавать? Начните с руководства по установке или перейдите сразу к быстрому старту.

Запуск FastMCP в продакшне с Horizon

FastMCP — это стандартный способ создания MCP-серверов. Prefect Horizon — это корпоративный MCP-шлюз для их безопасного запуска.

Созданная командой FastMCP, Horizon объединяет лучшие практики, которые мы накопили, создавая самую популярную MCP-фреймворк в мире.

Развертывайте FastMCP-серверы из GitHub с предварительными просмотрами веток и мгновенным откатом. Создавайте приватный реестр всех MCP, используемых вашей компанией. Обеспечивайте безопасный доступ с помощью SSO и ролевого контроля доступа на уровне инструментов. Получайте журналы аудита, наблюдаемость и управление для всего вашего MCP-стека. Комбинируйте одобренные инструменты в целевые эндпоинты для команд и агентов.

Начните с FastMCP. Масштабируйте с Horizon →

Установка

Мы рекомендуем устанавливать FastMCP с помощью uv:

uv pip install fastmcp

Полные инструкции по установке, включая проверку и обновление, см. в Руководстве по установке.

Обновляетесь? У нас есть руководства по: - Обновлению с FastMCP v2 - Обновлению с MCP Python SDK - Обновлению с низкоуровневого SDK

[!NOTE] Если import fastmcp не работает сразу после обновления через pip с FastMCP 3.2 или ранее, выполните pip install --force-reinstall fastmcp. Причина описана в разделе Устранение неполадок (uv не затронут).

📚 Документация

Полная документация FastMCP доступна на gofastmcp.com и включает подробные руководства, справочники по API и продвинутые паттерны.

Документация также доступна в формате llms.txt — простом стандарте Markdown, который LLM могут легко обрабатывать:

• llms.txt — по сути карта сайта, содержащая список всех страниц документации.
• llms-full.txt — содержит всю документацию. Обратите внимание, что этот файл может превышать контекстное окно вашей LLM.

Сообщество: Присоединяйтесь к нашему серверу Discord, чтобы общаться с другими разработчиками FastMCP и делиться тем, что вы создаёте.

Участие в разработке

Мы приветствуем вклад! Ознакомьтесь с Руководством по участию в разработке для получения инструкций по настройке, требованиям к тестированию и рекомендациям по PR.