𝗠𝗼𝗱𝗲𝗹 𝗖𝗼𝗻𝘁𝗲𝘅𝘁 𝗣𝗿𝗼𝘁𝗼𝗰𝗼𝗹 𝗘𝘅𝗽𝗹𝗮𝗶𝗻𝗲𝗱

Pare de escrever o mesmo código de integração repetidamente.

Se você conectar um LLM a um banco de dados ou a uma API, muitas vezes acabará escrevendo um código de integração (glue code) personalizado para cada novo modelo. Isso cria uma bagunça. Você acaba gerenciando muitas conexões para muitas ferramentas.

O Model Context Protocol (MCP) resolve isso. Ele funciona como uma porta USB-C para a IA. Você constrói uma ferramenta uma única vez, e qualquer modelo pode usá-la.

A arquitetura possui três partes:

• Host: O aplicativo que você usa, como o Claude Code ou uma IDE. • Client: O conector dentro do host. • Server: O programa que você constrói para expor dados ou ferramentas.

Você pode construir um servidor MCP usando três primitivas principais:

  • Tools: Funções que o modelo chama para realizar tarefas, como enviar um e-mail.
  • Resources: Dados de apenas leitura que o aplicativo busca, como um arquivo de log.
  • Prompts: Templates reutilizáveis para tarefas específicas.

Aqui está como construir um servidor básico em Python usando o FastMCP SDK:

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("demo-tools")

@mcp.tool()
def word_count(text: str) -> int:
    """Count words in a text."""
    return len(text.split())

@mcp.resource("notes://team")
def team_notes() -> str:
    """Expose team notes."""
    return "Release freeze starts Friday."

@mcp.prompt()
def code_review(language: str, code: str) -> str:
    """Template for code reviews."""
    return f"Review this {language} code: {code}"

if __name__ == "__main__":
    mcp.run()

Este código gerencia a comunicação complexa para você. Suas docstrings tornam-se as instruções para o modelo.

Três dicas para produção:

  1. Segurança: Sempre peça a aprovação do usuário antes de executar uma ferramenta que altere dados.
  2. Contexto: Mantenha as descrições das ferramentas curtas. Descrições longas desperdiçam tokens.
  3. Erros: Retorne mensagens claras. Um modelo pode corrigir um erro de "User not found", mas não consegue corrigir uma falha bruta no código (crash).

Pare de construir conectores sob medida. Construa um servidor MCP uma única vez e deixe que todos os modelos o utilizem.

Source: https://dev.to/galian/model-context-protocol-explained-build-your-first-mcp-server-in-python-ian