Перейти к содержимому
Выберите тему

Python SDK 2.0: FastMCP становится MCPServer

28 июля 2026 вышел Python SDK для MCP версии 2.0.0. FastMCP переименован в MCPServer, появился единый Client, типы протокола переехали в пакет mcp-types.

28 июля 2026 вышел Python SDK для MCP версии v2.0.0. Выпуск опубликован в хранилище modelcontextprotocol/python-sdk и назван стабильным выпуском v2. Он поддерживает редакцию 2026-07-28 и обслуживает все более ранние редакции с того же сервера. Команда pip install mcp теперь ставит версии 2.x.

Что изменилось

  • FastMCP теперь называется MCPServer. Модули mcp.server.fastmcp.* стали mcp.server.mcpserver.*, а FastMCPError - MCPServerError. Заметки к выпуску говорят, что интерфейс декораторов не изменился.
  • Появился единый Client. Один объект заменяет прежнюю связку из транспорта, ClientSession и вызова initialize(). Он подключается к адресу, к подпроцессу через stdio, к своему транспорту или прямо к объекту сервера в памяти - для тестов.
  • Типы протокола вынесены в отдельный пакет mcp-types, его импортируют как mcp_types. Пакет зависит только от pydantic и typing-extensions.
  • Один SDK работает с двумя эпохами протокола. v2 говорит на редакции 2026-07-28: запросы без состояния и без рукопожатия, server/discover, subscriptions/listen, многошаговые запросы. Тот же MCPServer обслуживает клиентов редакций 2025 года через Streamable HTTP и stdio. Client согласует версию сам.
  • Трассировка OpenTelemetry включена по умолчанию.

Заметки называют и то, чего в выпуске нет: расширение Tasks (SEP-2663) в него не вошло.

За день до выпуска, 27 июля 2026, был опубликован кандидат v2.0.0rc1.

Кого это касается

Тех, кто остаётся на версии 1. Заметки сообщают, что линия v1.x переведена в режим сопровождения. Она живёт в ветке v1.x. В одном месте заметок сказано, что она будет получать только исправления безопасности, в другом - что она продолжает получать исправления критических ошибок и исправления безопасности. Если проект не готов к переходу, заметки советуют ограничить версию сверху: например, mcp>=1.28,<2. Без такого ограничения pip install mcp поставит 2.x.

Тех, кто переходит на v2. Замените импорт FastMCP на MCPServer и проверьте импорты типов. Все несовместимые изменения с кодом до и после перечислены в руководстве по переходу, на которое ссылаются заметки.

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

Как это выглядит сейчас

Этот текст описывает день выхода v2.0.0. Текущий выпуск, установка и поведение клиента и сервера по умолчанию разобраны на странице «Python SDK». Как один сервер отвечает клиентам обеих эпох, рассказано на странице «Сервер для двух эпох».

Источники