Repolode
Enviar
modelcontextprotocol

modelcontextprotocol/python-sdk

SDK oficial de Python para criar servidores e clientes do Model Context Protocol que conectam aplicações com LLMs a ferramentas, dados e prompts.

Ver no GitHubSite
Estrelas
24,624
Forks
4,275
Issues abertas
361
Último commit
há 3 dias

O que é?

O MCP Python SDK é a implementação oficial em Python do Model Context Protocol, um padrão aberto para disponibilizar dados e funcionalidades a aplicações com LLMs de forma segura e padronizada. Ele permite que desenvolvedores criem servidores MCP que disponibilizam ferramentas, recursos e prompts para qualquer host MCP, além de clientes MCP que se conectam a qualquer servidor MCP.

Os servidores são definidos com funções Python comuns, com type hints e docstrings. Os type hints se tornam o schema de entrada, dispensando a criação manual de JSON Schema, o parsing de requisições e o tratamento do protocolo. O pacote inclui uma ferramenta de linha de comando `mcp` para executar servidores e abri-los no MCP Inspector.

O SDK oferece suporte aos transportes stdio, Streamable HTTP e SSE. Ele requer Python 3.11 ou mais recente e é distribuído sob a licença MIT.

Recursos principais

  • 01Crie servidores MCP que disponibilizam ferramentas, recursos e prompts por meio de funções Python com type hints.
  • 02Crie clientes MCP que se conectam a servidores locais via stdio ou a servidores remotos via Streamable HTTP.
  • 03Oferece suporte aos transportes stdio, Streamable HTTP e SSE.
  • 04Inclui uma CLI `mcp` para executar servidores e iniciar o MCP Inspector.

Casos de uso

  • Disponibilizar APIs internas ou bancos de dados como ferramentas MCP para um assistente com LLM.
  • Criar um cliente Python que chama ferramentas em um servidor MCP existente.
  • Prototipar e depurar servidores MCP com o MCP Inspector.

Início rápido

  1. 1

    Instale o SDK com o extra CLI usando uv

    uv add "mcp[cli]"
  2. 2

    Ou instale com pip

    pip install "mcp[cli]"
  3. 3

    Crie server.py com uma ferramenta e um recurso (consulte o exemplo no README)

  4. 4

    Execute o servidor no MCP Inspector

    uv run mcp dev server.py

Antes de usar

  • Requer Python 3.11 ou mais recente.
  • A documentação do README aborda uma API v2, então tutoriais e exemplos mais antigos podem não corresponder.

Tópicos

#mcp#llm#ai-agents#python-sdk#tool-calling#model-context-protocol#mcp-client#mcp-server#python

Perguntas frequentes

O que é python-sdk?
SDK oficial de Python para criar servidores e clientes do Model Context Protocol que conectam aplicações com LLMs a ferramentas, dados e prompts. O MCP Python SDK é a implementação oficial em Python do Model Context Protocol, um padrão aberto para disponibilizar dados e funcionalidades a aplicações com LLMs de forma segura e padronizada. Ele permite que desenvolvedores criem servidores MCP que disponibilizam ferramentas, recursos e prompts para qualquer host MCP, além de clientes MCP que se conectam a qualquer servidor MCP.
python-sdk é gratuito? Qual é a licença?
python-sdk é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
python-sdk ainda é mantido?
Manutenção ativa. O último commit de python-sdk foi em 17 de out. de 2026.
Para que posso usar python-sdk?
Disponibilizar APIs internas ou bancos de dados como ferramentas MCP para um assistente com LLM. Criar um cliente Python que chama ferramentas em um servidor MCP existente. Prototipar e depurar servidores MCP com o MCP Inspector.
Como instalar python-sdk?
Instale o SDK com o extra CLI usando uv: uv add "mcp[cli]" Ou instale com pip: pip install "mcp[cli]" Crie server.py com uma ferramenta e um recurso (consulte o exemplo no README) Execute o servidor no MCP Inspector: uv run mcp dev server.py
Onde consigo python-sdk?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/modelcontextprotocol/python-sdk

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados