FastMCP

---

O Model Context Protocol (MCP) conecta LLMs a ferramentas e dados. FastMCP é um framework completo de aplicações MCP para servidores, clientes e aplicativos interativos. Um servidor começa com Python comum:

from fastmcp import FastMCP

mcp = FastMCP("Demo 🚀")

@mcp.tool
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

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

Por que FastMCP

Construir uma aplicação MCP eficaz é mais difícil do que parece. FastMCP cuida de tudo isso. Declare uma ferramenta com uma função Python, e o schema, a validação e a documentação são gerados automaticamente. Conecte-se a um servidor com uma URL, e a negociação de transporte, autenticação e ciclo de vida do protocolo são gerenciados para você. Você foca na sua lógica, e a parte MCP simplesmente funciona: com FastMCP, as melhores práticas já vêm embutidas.

É por isso que FastMCP é o framework padrão para trabalhar com MCP. O FastMCP 1.0 foi incorporado ao SDK oficial de Python do MCP em 2024. Hoje, o projeto independente mantido ativamente é baixado um milhão de vezes por dia, e alguma versão do FastMCP alimenta 70% dos servidores MCP em todas as linguagens.

FastMCP tem três pilares:

Servidores Exponha ferramentas, recursos e prompts para LLMs.

Aplicativos Dê às suas ferramentas UIs interativas renderizadas diretamente na conversa.

Clientes Conecte-se a qualquer servidor MCP — local ou remoto, programático ou CLI.

Servidores transformam suas funções Python em ferramentas, recursos e prompts compatíveis com MCP. Clientes conectam-se a qualquer servidor com suporte completo ao protocolo. E Aplicativos dão às suas ferramentas UIs interativas renderizadas diretamente na conversa.

Desenvolvendo em TypeScript? FastMCP para TypeScript é a contraparte oficial, construída e mantida pela mesma equipe. Mesmos pilares, mesmas ideias, npm install @prefecthq/fastmcp-ts.

Pronto para construir? Comece com o guia de instalação ou vá direto para o quickstart.

Escale MCP com Horizon

FastMCP cuida da camada de aplicação MCP. Prefect Horizon é o gateway MCP empresarial para escalar servidores e ferramentas entre equipes, com governança centralizada sobre como eles são implantados, descobertos, protegidos e usados.

FastMCP e Horizon são construídos pela mesma equipe na Prefect.

Implante servidores FastMCP a partir do GitHub com previews de branch e rollback instantâneo. Crie um registro privado de cada MCP que sua empresa usa. Proteja o acesso com SSO e RBAC em nível de ferramenta. Obtenha logs de auditoria, observabilidade e governança em toda a sua pilha MCP. Remixe ferramentas aprovadas em endpoints específicos para equipes e agentes.

Comece com FastMCP. Escale com Horizon →

Instalação

Recomendamos adicionar FastMCP ao seu projeto com uv:

uv add fastmcp

Para instruções completas de instalação, incluindo verificação e atualização, consulte o Guia de Instalação.

Atualizando? Temos guias para:

• Atualizando do FastMCP 3
• Atualizando do FastMCP 2
• Atualizando do MCP SDK v1 ou v2
• Atualizando do SDK de baixo nível v1 ou v2

📚 Documentação

A documentação completa do FastMCP está disponível em gofastmcp.com, incluindo guias detalhados, referências de API e padrões avançados.

A documentação também está disponível no formato llms.txt, que é um padrão simples de markdown que LLMs podem consumir facilmente:

• llms.txt é essencialmente um sitemap, listando todas as páginas da documentação.
• llms-full.txt contém toda a documentação. Observe que isso pode exceder a janela de contexto do seu LLM.

Comunidade: Junte-se ao nosso servidor Discord para se conectar com outros desenvolvedores FastMCP e compartilhar o que você está construindo.

Contribuindo

Comece com CONTRIBUTING.md para contribuições aceitas e o fluxo de trabalho de atribuição de issues, depois siga o Guia de Contribuição para configuração e validação. Agentes devem ler AGENTS.md.