Ferramentas assíncronas que não bloqueiam

Se uma ferramenta executar trabalho lento de forma síncrona, ela bloqueia o servidor inteiro, fazendo com que todas as outras chamadas tenham de esperar sua vez. ⏳

Uma ferramenta que chama um banco de dados ou uma API passa a maior parte do tempo em E/S, apenas esperando uma resposta em vez de usar a CPU.

Marcar uma ferramenta como assíncrona permite que o servidor processe outras solicitações durante essa espera, em vez de ficar ocioso em uma única chamada.

Declare seu manipulador com async def e o FastMCP aguardará sua execução, permitindo que o ciclo de eventos atenda a outros trabalhos enquanto isso.

Dentro de uma ferramenta assíncrona, use await em bibliotecas assíncronas, para que cada pausa devolva o controle ao ciclo em vez de congelá-lo.

Prefira clientes como httpx ou asyncpg. Eles foram criados para aguardar operações, ao contrário das bibliotecas bloqueantes, que paralisam todo o ciclo.

Um time.sleep simples ou um ciclo pesado bloqueia todas as outras solicitações. Em código assíncrono, chamadas bloqueantes congelam o servidor silenciosamente.

Para cálculos realmente intensivos na CPU, transfira o trabalho para uma thread com asyncio.to_thread, mantendo o ciclo de eventos livre para atender chamadas.

Precisa fazer várias buscas ao mesmo tempo? asyncio.gather executa objetos aguardáveis em conjunto, terminando muito mais rápido do que aguardar cada um por vez.

Envolva esperas lentas em um timeout, para que um sistema upstream travado não mantenha uma solicitação ocupada para sempre nem prive o servidor de recursos.

Com E/S assíncrona, um processo pode administrar muitas chamadas em andamento ao mesmo tempo, mantendo o servidor responsivo sob uma carga real.

Você tornou as ferramentas assíncronas, aguardou a E/S, descarregou o trabalho da CPU e executou chamadas em conjunto, para que uma ferramenta lenta não congele mais o servidor. 🚀