PrefectHQ/fastmcp

Исправлено сохранение маршрутов инструментов ClientGroup после выхода из контекста группы.

• Fixed: Исправлено сохранение известных маршрутов инструментов ClientGroup после выхода из контекста группы, что позволяет вызывать инструменты с подключением только своего клиента.

Важные исправления: сохранение параметров запросов, передача аргументов скриптов, строгая валидация OpenAPI и корректное сравнение JSON-значений.

• Fixed: Исправлена потеря параметров списка запросов в шаблонах ресурсов FastMCPProviderResourceTemplate.
• Fixed: FastMCPStdioTransport теперь корректно передаёт аргументы скрипта.
• Fixed: Валидация OpenAPI-инструментов стала строже: отклоняются необъявленные аргументы и сохраняются таймауты.
• Fixed: JSON Schema const/enum теперь сравниваются по JSON-эквивалентности, предотвращая ложные совпадения типов.
• Fixed: Исправлена обработка отсутствующих обязательных аргументов в промптах и устранены утечки контекста клиента.

Обновление certifi из-за компрометации CA, исправление OAuth, таймаутов и генераторов; требуется обновление системных хранилищ доверия.

• Breaking: Требует certifi 2026.10.19+; одного обновления FastMCP недостаточно — необходимо обновить системные, контейнерные и пользовательские хранилища доверия.
• Fixed: Исправлена аутентификация OAuth для публичных клиентов без client secret.
• Fixed: Устранена ошибка, при которой таймаут внутри инструмента ошибочно классифицировался как таймаут самого инструмента.
• Fixed: Исправлено сохранение пустых значений видимости сессии и материализация результатов генераторов в TransformedTool.
• Fixed: Теперь учитываются таймауты, заданные в конфигурации для каждого MCP-сервера.

Исправлено обнаружение связанных папок навыков, ограничена длина и время выполнения regex-поиска, устранены мелкие ошибки.

• Fixed: SkillsDirectoryProvider снова корректно обнаруживает папки навыков, являющиеся ссылками, в том числе на папки вне корня.
• Fixed: Поиск по регулярным выражениям теперь отклоняет паттерны длиннее 1000 символов и ограничивает время выполнения одной секундой.
• Fixed: Некорректная настройка прокси больше не прерывает проверку обновлений.
• Fixed: Исправлено очищение блокировки обновления JWKS от атрибутов подклассов.
• Fixed: В маршрутах component manager параметр версии запроса теперь корректно преобразуется в VersionSpec.

Исправлена работа задач в инструментах за поисковыми трансформами и CodeMode, а также запуск вложенных вызовов в foreground.

• Fixed: Инструменты с задачами теперь корректно регистрируются и возвращают результаты, даже если скрыты поисковыми трансформами или CodeMode.
• Fixed: Вызовы инструментов из других инструментов через ctx.fastmcp.call_tool() теперь выполняются в foreground, а не возвращают пустые квитанции.
• Fixed: Добавлена устойчивость stdio-транспорта к ошибкам в методе __del__ при неудачной инициализации.
• Обновлена документация: добавлена ссылка на Bluesky в футер и записи о версии v4.0.10.

Исправлено утечка памяти в ResourceTemplate: шаблон теперь хранит скомпилированный URI, кэш ограничен.

• Fixed: ResourceTemplate теперь сохраняет скомпилированный шаблон URI, что предотвращает рост памяти из-за динамических прокси.
• Fixed: Возобновлено ограничение размера общего кэша, что устраняет падение производительности при работе с 4096 шаблонами.
• Обновлены записи в журнале изменений для версии v4.0.9.

Возврат поведения завершения к версии 4.0.5, исправление отзыва токена OAuthProxy и оптимизация кэширования шаблонов ресурсов.

• Fixed: Возвращено поведение завершения (completions) как в версии 4.0.5 для устранения уязвимости, когда скрытые промпты могли кэшироваться и передаваться другим клиентам.
• Fixed: OAuthProxy теперь корректно отзывает токен обновления у провайдера, а не отправляет свой собственный токен.
• Fixed: Убрано ограничение размера кэша для скомпилированных шаблонов ресурсов, что ускоряет работу серверов с тысячами шаблонов.

Исправлены регрессии 4.0.6: корректная работа middleware для completions и кэширование шаблонов ресурсов.

• Fixed: Исправлена проверка видимости в completions: теперь middleware-хуки вызываются только для списочных операций, что восстанавливает корректную работу лимитов, логирования и метрик.
• Fixed: Добавлено кэширование скомпилированных шаблонов URI для ресурсов, что ускоряет их чтение по сравнению с версией 4.0.5.

Исправлено игнорирование строгой валидации полей (strict=True) при вызовах и отправке задач.

• Fixed: Восстановлена корректная работа строгой валидации параметров инструментов (Field(strict=True), StrictInt) при прямых вызовах и отправке задач.
• Fixed: Исправлено поведение сервера, которое в lax-режиме ранее молча приводило значения к типу, игнорируя строгие настройки.
• Added: Добавлен регрессионный тест для защиты от повторения проблемы с неконфигурированным ID-JAG guard.
• Обновлена документация с записями о выпуске версии v4.0.5.

Исправлена двойная отправка изображений, устранены ошибки таймингов задач и очищены неиспользуемые колбэки.

• Fixed: Устранена проблема дублирования изображений при возврате неограниченных последовательностей.
• Fixed: Исправлена сериализация полей тайминга задач, которые отклонялись строгими клиентами.
• Fixed: Оптимизирован запуск: устранены лишние повторные попытки для клиентов с несколькими серверами и устаревшими бэкендами.
• Fixed: Очищены незавершенные колбэки Monty при завершении выполнения.

Исправлена повторная вложенность контекста ClientGroup и обновлена документация для версии 4.0 GA.

• Fixed: ClientGroup теперь поддерживает повторное вхождение контекста, переиспользуя существующие соединения вместо ошибок.
• Fixed: Исправлен шаг создания PR с опубликованной документацией в CI.
• Added: Обновлены баннеры и руководства по миграции для официального релиза FastMCP 4 GA.
• Added: Удалено упоминание предварительных версий из инструкций по установке и миграции SDK.

Исправлена валидация audience для private_key_jwt в OAuthProxy, устраняющая ошибку несоответствия.

• Fixed: Восстановлена корректная работа аутентификации CIMD private_key_jwt для OAuthProxy-развертываний.
• Fixed: Исправлено несоответствие audience, вызванное двойным слэшем, за счет валидации против точного endpoint из метаданных.
• Added: В бэкпорт версии v3 добавлено исправление аудитории утверждений CIMD.

FastMCP 3.4.6: поддержка SSRF-защиты через прокси для OAuth и JWKS, отказ от прямых запросов без прокси.

• Fixed: Добавлена поддержка доверенных прокси для SSRF-защиты при запросах OAuth metadata и JWKS.
• Fixed: FastMCP теперь блокирует прямые запросы, если прокси не настроен, предотвращая риски безопасности.
• Added: Развертывания могут маршрутизировать запросы через корпоративный прокси с сохранением пользовательских CA-сертификатов.

Исправлена критическая ошибка JWT-верификации при наличии ключей Ed25519 в JWKS, а также ряд улучшений стабильности.

• Fixed: Исправлена ошибка, из-за которой JWTVerifier отклонял все токены, если в JWKS присутствовал ключ Ed25519.
• Fixed: Устранена проблема с фоллбэком scopes в Azure.
• Fixed: Добавлена сериализация глубоких объектных query-параметров.
• Fixed: Обеспечена детерминированная сортировка обязательных параметров у трансформированных инструментов.
• Fixed: Исправлено побочное изменение схемы вызывающей стороны в функции compress_schema.

Исправлена совместимость JWT для провайдеров, использующих нестандартные заголовки, например Clerk.

• Fixed: Разрешены приватные заголовки JWT, что устраняет ошибки валидации для токенов от таких провайдеров, как Clerk.
• Fixed: Критические заголовки, не поддерживаемые системой, по-прежнему отклоняются для обеспечения безопасности.
• Обновлена документация: добавлены записи о изменениях для версии 3.4.1.