O que é MCP Python SDK?
O Model Context Protocol (MCP) é uma forma padronizada de aplicativos de IA se conectarem a ferramentas e dados. Este é o SDK oficial em Python para escrever servidores MCP (que expõem ferramentas) e clientes (que as usam). Também existe um SDK oficial em TypeScript, além de SDKs em Go e C#.
A versão 2.0 saiu em 28 de julho de 2026, junto com a revisão 2026-07-28 da especificação. A classe FastMCP foi renomeada para MCPServer, um único objeto Client substituiu as antigas camadas de sessão e o transporte WebSocket foi removido. Os servidores continuam respondendo a clientes antigos.
A linha 1.x está em modo de manutenção, só com correções de segurança.
MCP Python SDK vale a pena?
Esta é a implementação de referência em Python do Model Context Protocol, e ela acompanha a especificação antes de qualquer outra. A versão 2.0 saiu em 28 de julho de 2026, junto com a revisão 2026-07-28 da especificação, e atende essa revisão e a 2025-11-25 ao mesmo tempo, então um servidor v2 continua respondendo a clientes antigos sem nada a configurar. A versão mais recente é a v2.3.0, de 2 de outubro de 2026.
O custo é a migração. FastMCP virou MCPServer, o caminho do módulo mudou, get_context() deixou de existir, as configurações de transporte saíram do construtor e foram para run(), e o Server de baixo nível foi refeito em torno de argumentos do construtor em vez de decorators. Os caminhos antigos foram removidos, não descontinuados. O transporte WebSocket, que nunca fez parte da especificação, saiu, assim como a API experimental de Tasks. A linha 1.x segue em manutenção com correções de segurança, mas nenhuma data de fim foi publicada; fixar mcp>=1.28,<2 é a forma documentada de esperar.
O trabalho de segurança tem sido intenso. O repositório publicou 12 alertas, incluindo um bug de alta gravidade em que as sessões Streamable HTTP nunca eram liberadas por padrão (corrigido na 1.30.0 e na 2.2.0) e uma verificação de bearer token que aceitava tokens emitidos para outro servidor de recursos. Quem roda um servidor HTTP na 2.0 ou na 2.1 deve atualizar.
O projeto independente FastMCP, agora na v4.1.3 sob a PrefectHQ, tem cerca de 28.200 estrelas contra 24.700 deste SDK e acrescenta mais conveniências por cima. O SDK oficial é a escolha mais enxuta quando o comportamento exato da especificação importa mais que os extras.
Onde ele se destaca
Um desenvolvedor de backend expondo uma API interna baseada em Postgres ao Claude e a outros clientes MCP
Entregar um servidor MCP que a equipe de segurança aprove
Escreva as ferramentas como funções decoradas no MCPServer, rode por Streamable HTTP atrás da sua autenticação e fique na 2.2.0 ou posterior por causa das correções de liberação de sessões e de audiência de tokens. Um primeiro servidor tem algumas dezenas de linhas.
Uma equipe de plataforma que mantém dez servidores MCP v1
Planejar a mudança para a v2 sem quebrar clientes
Fixe mcp>=1.28,<2 para continuar recebendo correções de segurança e depois migre um servidor por vez usando a lista de antes e depois do guia de migração. Como a v2 atende as duas revisões da especificação, os clientes não precisam mudar ao mesmo tempo.
Um gerente de engenharia escolhendo uma stack MCP em Python para um produto novo
Decidir entre o SDK oficial e o FastMCP
O SDK oficial é MIT, mantido pelo projeto MCP e acompanha a especificação primeiro; o FastMCP acrescenta mais recursos prontos por cima. Os dois são gratuitos, então a escolha é entre fidelidade à especificação e conveniência, e o volume de mudanças a cada atualização.
Antes de decidir
- Configuração
- uv add "mcp[cli]" ou pip install "mcp[cli]" em Python 3.10+; uv run mcp run server.py --transport streamable-http inicia um servidor. Uma ferramenta decorada e uma primeira chamada levam minutos.
- Integrações
- Funciona com qualquer cliente MCP, incluindo aplicativos Claude e frameworks de agentes; traz um Client para chamar servidores por stdio ou Streamable HTTP, e existem SDKs irmãos em TypeScript, Go e C#. Os tipos do protocolo ficam em um pacote separado, mcp-types.
- Dados e privacidade
- É uma biblioteca: por si só não envia nada a lugar nenhum. O seu servidor vê tudo o que as ferramentas dele alcançam, então autenticação e escopo são responsabilidade sua. 12 alertas publicados, incluindo vazamento de sessões por Streamable HTTP e um cliente que buscava URLs $ref escolhidas pelo servidor durante a validação de schemas.
- Custo em escala
- Gratuito sob MIT. Hospedar um servidor é hospedagem web Python comum; requisições da era 2026 não carregam sessão, o que tira o roteamento com sessões fixas do problema de hospedagem.
- Limites
- Cerca de 370 issues abertas. Em conexões da era 2026, as requisições iniciadas pelo servidor deixaram de existir, então ctx.elicit() falha e Resolve(...) o substitui; roots, sampling e o logging do protocolo estão descontinuados, e o ping foi removido.
O que é bom
- Primeiro a implementar novas revisões da especificação
- Servidores v2 atendem clientes 2026-07-28 e 2025-11-25
- Decorators para ferramentas, recursos e prompts no MCPServer
- Transportes stdio, Streamable HTTP e SSE
O que não é
- A v2 removeu de vez os caminhos de import da v1
- Transporte WebSocket e API de Tasks eliminados
- 12 alertas de segurança; 2.0 e 2.1 precisam ser atualizadas
- Menos extras que o FastMCP independente
Ideal para
Desenvolvedores Python que constroem servidores ou clientes MCP e querem a implementação oficial, que acompanha a especificação.
Alternativas ao MCP Python SDK
MCP Python SDK: perguntas frequentes
- MCP Python SDK vale a pena?
- O caminho que segue a especificação à risca para construir MCP em Python; a versão 2 é mais limpa e quebra todos os imports da v1 no caminho. Damos nota 4.4 de 5.
- Quanto custa MCP Python SDK?
- Gratuito e de código aberto sob a licença MIT.
- Quais são as desvantagens de MCP Python SDK?
- A v2 removeu de vez os caminhos de import da v1; transporte WebSocket e API de Tasks eliminados; 12 alertas de segurança; 2.0 e 2.1 precisam ser atualizadas; menos extras que o FastMCP independente.
- Para quem MCP Python SDK é indicado?
- Desenvolvedores Python que constroem servidores ou clientes MCP e querem a implementação oficial, que acompanha a especificação.
- Quanto custa MCP Python SDK para uma equipe ou em produção?
- Gratuito sob MIT. Hospedar um servidor é hospedagem web Python comum; requisições da era 2026 não carregam sessão, o que tira o roteamento com sessões fixas do problema de hospedagem.
- MCP Python SDK é seguro para dados da empresa?
- É uma biblioteca: por si só não envia nada a lugar nenhum. O seu servidor vê tudo o que as ferramentas dele alcançam, então autenticação e escopo são responsabilidade sua. 12 alertas publicados, incluindo vazamento de sessões por Streamable HTTP e um cliente que buscava URLs $ref escolhidas pelo servidor durante a validação de schemas.
- Quais são as melhores alternativas ao MCP Python SDK?
- As alternativas mais próximas que analisamos são OpenAI Agents SDK e Pydantic AI.
Respostas verificadas em 23 de out. de 2026.