Pular para conteúdo

Instalação

Tradução automática

Esta página foi traduzida automaticamente a partir da documentação em inglês, e a página em inglês é a versão de referência. Se algo parecer errado, Traduções explica como avisar.

O SDK Python está no PyPI como mcp. Ele requer Python 3.10+.

Esta documentação descreve a v2, a linha de versões estável atual:

uv add "mcp[cli]"

pip install "mcp[cli]"

Vindo da v1?

A v2 é uma versão major com quebras de compatibilidade; o Guia de migração cobre todas elas. Se o seu pacote depende de mcp e ainda não está pronto para migrar, mantenha um limite superior <2 (por exemplo mcp>=1.28,<2) para que uma resolução sem versão fixada continue na linha 1.x.

O que é instalado

Você não precisa saber nada disso para usar o SDK, mas, se quiser saber para que serve cada dependência:

  • mcp-types: todos os tipos do protocolo (requisições, resultados, blocos de conteúdo) em um pacote próprio, versionado em sincronia com o SDK. O código que depende de mcp o importa pelo alias mcp.types (todo from mcp.types import ... nesta documentação); importe mcp_types diretamente apenas em um projeto que instala mcp-types sem o SDK.
  • anyio: o runtime assíncrono. O SDK inteiro é escrito sobre o anyio, então roda tanto com asyncio quanto com trio.
  • pydantic: a base de todos os modelos de mcp.types, além de toda a geração e validação de schemas.
  • httpx2: o cliente HTTP por trás dos transportes de cliente Streamable HTTP e SSE, com suporte embutido a server-sent events.
  • starlette, uvicorn, sse-starlette e python-multipart: os transportes HTTP de servidor.
  • jsonschema: valida a saída estruturada de uma ferramenta (tool) contra o schema de saída declarado por ela.
  • pyjwt[crypto]: tratamento de tokens OAuth para autorização.
  • opentelemetry-api: apenas a API leve, então o middleware de tracing do SDK não custa nada, a menos que você mesmo instale um SDK e um exporter do OpenTelemetry.
  • typing-extensions e typing-inspection: funcionalidades modernas de tipagem no Python 3.10.
  • pywin32: somente no Windows, usado para o gerenciamento de subprocessos stdio.

Extras opcionais

  • mcp[cli] adiciona typer e python-dotenv para a ferramenta de linha de comando mcp (mcp dev, mcp run, mcp install). Você vai querer isso durante o desenvolvimento; talvez não precise dele em um servidor depois do deploy.
  • mcp[rich] adiciona rich para logs de servidor mais bonitos.