Обработчик запуска с учётом времени жизни

Некоторые действия по настройке следует выполнять один раз при запуске сервера, например открывать соединение с базой данных, а не при каждом вызове инструмента. 🚀

lifespan — это хук, который выполняет код запуска до поступления запросов, а затем код освобождения ресурсов после остановки сервера.

lifespan — это асинхронный менеджер контекста: код до yield выполняется при запуске, а код после yield — при завершении работы.

Передайте lifespan серверу в аргументе lifespan, чтобы FastMCP выполнял его на протяжении всего времени работы сервера.

Блок запуска — подходящее место для ресурсоёмкой настройки: пулов соединений с базой данных, HTTP-клиентов или загрузки модели в память.

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

FastMCP гарантирует, что Ваш код запуска завершится до принятия первого вызова инструмента, поэтому ресурсы будут готовы вовремя.

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

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

У сервера ровно один lifespan. Соберите в нём всю логику запуска, а не распределяйте настройку по инструментам.

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

Вы изучили lifespan — асинхронный менеджер контекста, который выполняет настройку до yield, передаёт общее состояние через yield и освобождает ресурсы после него. Далее: передача этого состояния. 🎯