Configure o Python 3.11+ e o gerenciador de pacotes uv — as ferramentas base para criar MCP Servers em Python.
Python é a linguagem de programação mais popular do mundo para desenvolvimento de IA, automação e scripting. Sua sintaxe clara e legível a torna ideal tanto para iniciantes quanto para profissionais experientes. No contexto do MCP, Python é a escolha número um graças ao SDK oficial FastMCP, que simplifica enormemente a criação de servidores MCP.
Python é uma linguagem de programação de alto nível, interpretada e de tipagem dinâmica. No ecossistema MCP, Python se destaca por oferecer o SDK FastMCP — uma biblioteca que permite criar servidores MCP completos com poucas linhas de código. A combinação de simplicidade do Python com a praticidade do FastMCP torna possível criar um MCP Server funcional em menos de 10 minutos, mesmo para quem nunca programou antes.
Python é usado em 60%+ dos MCP Servers publicados pela comunidade. A linguagem lidera o índice TIOBE de popularidade há anos consecutivos e possui o maior ecossistema de bibliotecas de IA do mundo — incluindo TensorFlow, PyTorch, LangChain e, claro, o FastMCP. A comunidade Python contribui com mais de 500.000 pacotes no PyPI, garantindo que você sempre encontrará uma biblioteca para qualquer necessidade de integração.
O primeiro passo para criar MCP Servers em Python é instalar a versão correta da linguagem. O FastMCP requer Python 3.11 ou superior, pois utiliza recursos modernos da linguagem como tipagem avançada e asyncio aprimorado. O processo de instalação varia por sistema operacional, mas é simples em todos eles.
O Python 3.11+ é necessário porque o FastMCP e o SDK oficial do MCP utilizam recursos introduzidos nessa versão, como Exception Groups, melhorias significativas de performance (até 25% mais rápido que 3.10) e tipagem avançada com suporte nativo a tipos genéricos. Instalar uma versão anterior pode causar erros de importação e incompatibilidades difíceis de diagnosticar.
Acesse python.org/downloads, baixe o instalador e execute. Marque obrigatoriamente a opção "Add Python to PATH" antes de clicar em Install. Após a instalação, abra o PowerShell e teste com python --version.
Instale via Homebrew: brew install python. O Homebrew já configura o PATH automaticamente. Caso não tenha o Homebrew, instale-o primeiro em brew.sh.
Ubuntu/Debian: sudo apt update && sudo apt install python3.11. Fedora/RHEL: sudo dnf install python3.11. A maioria das distros já vem com Python, mas pode ser uma versão anterior.
Verifique a versão mínima! Execute python --version ou python3 --version e confirme que é 3.11 ou superior. Versões como 3.9 ou 3.10 podem parecer funcionar inicialmente, mas causarão erros quando você tentar usar o FastMCP. No Linux, o comando pode ser python3 em vez de python.
O uv é um gerenciador de pacotes e ambientes Python de nova geração, escrito em Rust pela empresa Astral. Ele substitui simultaneamente o pip, o venv e o pip-tools, oferecendo uma experiência unificada e drasticamente mais rápida. Se o Python é o motor dos seus MCP Servers, o uv é o combustível de alta performance que faz tudo rodar sem atrito.
O uv é um gerenciador de pacotes Python ultrarrápido, escrito em Rust, que unifica as funcionalidades do pip (instalação de pacotes), venv (ambientes virtuais) e pip-tools (resolução de dependências) em uma única ferramenta. Ele resolve e instala dependências de 10 a 100 vezes mais rápido que o pip tradicional, possui lockfiles nativos para builds reproduzíveis e cria ambientes virtuais automaticamente quando necessário.
Pense no uv como o "npm do Python" — uma ferramenta moderna que gerencia tudo: criação de projetos, instalação de pacotes, ambientes isolados e lockfiles. Enquanto o pip exige que você crie um venv manualmente, instale pacotes separadamente e gerencie requirements.txt na mão, o uv faz tudo isso com comandos simples como uv init e uv add.
Em benchmarks reais, o uv instala dependências 10-100x mais rápido que o pip. Um projeto com 50 dependências que leva 45 segundos no pip é resolvido em menos de 1 segundo pelo uv. O projeto ultrapassou 30.000 stars no GitHub em menos de um ano desde o lançamento, sendo adotado por empresas como Pydantic, FastAPI e pelo próprio SDK oficial do MCP. A Astral, empresa criadora do uv, recebeu mais de US$ 30 milhões em investimentos para desenvolver ferramentas Python de nova geração.
A instalação do uv é rápida e direta — um único comando no terminal é suficiente. O uv se instala como um binário standalone, sem depender do pip ou de qualquer outra ferramenta Python previamente instalada. Isso significa que ele funciona imediatamente, sem complicações de dependências circulares.
O uv é distribuído como um binário standalone compilado em Rust — não é um pacote Python instalado via pip. Isso elimina o problema clássico do "ovo e da galinha": você não precisa ter pip para instalar o gerenciador de pacotes. O script de instalação oficial detecta automaticamente seu sistema operacional e arquitetura, baixa o binário correto e configura o PATH.
Comandos de instalação por sistema operacional:
curl -LsSf https://astral.sh/uv/install.sh | sh
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
pip install uv)uv --versionuv self updateApós instalar Python e uv, é crucial verificar que ambas as ferramentas estão funcionando corretamente e acessíveis no terminal. Problemas de PATH são a causa mais comum de frustração para iniciantes — vamos garantir que tudo está configurado antes de prosseguir.
A verificação da instalação consiste em confirmar que os comandos python e uv são reconhecidos pelo terminal e executam as versões corretas. Se um comando retorna "não reconhecido" ou "command not found", significa que o executável não está no PATH do sistema — a lista de diretórios onde o terminal procura por programas.
Execute python --version (ou python3 --version no Linux/Mac). Deve mostrar Python 3.11.x ou superior.
Execute uv --version. Deve mostrar a versão instalada (ex: uv 0.5.x ou superior).
Execute uv python list para verificar que o uv detecta as instalações de Python no seu sistema.
~/.bashrc ou ~/.zshrc.python3.11 explicitamente ou atualize.Agora que Python e uv estão instalados e verificados, vamos fazer um teste prático: criar um projeto Python com uv e instalar o FastMCP. Este teste confirma que todo o ambiente está configurado corretamente e pronto para criar MCP Servers.
O comando uv init cria um novo projeto Python com a estrutura padrão — incluindo pyproject.toml (configuração do projeto), um diretório para código-fonte e um arquivo .python-version. O comando uv add instala pacotes e os registra automaticamente como dependências, criando um ambiente virtual isolado se necessário. Juntos, esses dois comandos substituem toda a cerimônia do python -m venv + pip install + edição manual do requirements.txt.
Execute os comandos abaixo passo a passo no terminal:
uv init meu-projeto
cd meu-projeto
uv add fastmcp
Se o FastMCP instalar sem erros, seu ambiente está 100% pronto para criar MCP Servers!
uv inituv init para novos projetosuv add em vez de pip installuv.lock no GitPróximo Módulo: 2.2 — Instalando Node.js e npm