Arquitetura de servidor em camadas
Separe transporte, manipuladores e lógica de negócio.
Arquitetura de servidor em camadas é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Por que um único arquivo grande é prejudicial
Um servidor comprimido em um único arquivo mistura transporte, lógica das ferramentas e chamadas de dados. À medida que cresce, cada alteração corre o risco de quebrar algo distante.
Pense em camadas
Um servidor organizado se divide em camadas: transporte na borda, manipuladores MCP no meio e lógica de negócio pura na base.
A camada de transporte
A camada externa de transporte apenas movimenta mensagens, por stdio ou HTTP. Ela não deve saber nada sobre o que suas ferramentas realmente fazem.
Manipuladores são adaptadores finos
Os manipuladores de suas ferramentas e recursos devem ser simples: analisar argumentos, chamar um serviço e estruturar o resultado. Mantenha o trabalho real fora deles.
@mcp.tool()
def summarize(text: str) -> str:
return service.summarize(text)A camada de serviço faz o trabalho
Coloque a lógica real em um módulo de serviço simples, sem importações do MCP. Ele é apenas Python normal, que você pode chamar de qualquer lugar.
def summarize(text: str) -> str:
return shorten(clean(text))Por que a separação compensa
Com a lógica desacoplada do MCP, você pode testá-la sem iniciar um servidor e reutilizá-la mais tarde em uma CLI ou aplicativo web.
As dependências apontam para dentro
Mantenha a regra em uma única direção: os manipuladores podem importar serviços, mas os serviços nunca devem importar manipuladores nem o transporte acima deles.
Uma pasta por responsabilidade
Mapeie as camadas para pastas, para que a estrutura conte a história: a entrada do servidor, os manipuladores, os serviços e os modelos têm, cada um, seu próprio lugar.
src/
server.py
handlers/
services/
models.pyRegistre, não defina, na entrada
Seu server.py deve conectar os manipuladores à instância do FastMCP, não conter lógica. Ele é um ponto de montagem, não o responsável pelo trabalho.
from handlers import register_tools
register_tools(mcp)Mantenha os auxiliares transversais compartilhados
Registro, configuração e validação são responsabilidades compartilhadas. Dê a elas um módulo comum para que todas as camadas usem os mesmos auxiliares.
Cresça sem reescrever
A divisão em camadas permite que o servidor cresça: adicione uma nova ferramenta acrescentando um manipulador e um serviço, sem alterar o restante.
Verificação rápida
Onde deve ficar a lógica de negócio real de uma ferramenta?
Recapitulação: design em camadas
Divida seu servidor em transporte, manipuladores simples e serviços puros, com as dependências apontando para dentro. A seguir: configuração. 🧱
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Arquitetura de servidor em camadas” é grátis?
Sim — o texto completo de “Arquitetura de servidor em camadas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Arquitetura de servidor em camadas”?
Separe transporte, manipuladores e lógica de negócio. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Arquitetura de servidor em camadas”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Arquitetura de servidor em camadas
- Configuração e segredos pelo ambiente
- Ferramentas idempotentes e conscientes dos efeitos colaterais
- Versionar ferramentas e esquemas