Ana içeriğe geç

Kurulum

Makine çevirisi

Bu sayfa İngilizce dokümantasyondan otomatik olarak çevrildi; esas alınması gereken sürüm İngilizce sayfadır. Yanlış görünen bir şey varsa, nasıl bildireceğinizi Çeviriler sayfası açıklar.

Python SDK, PyPI'da mcp adıyla yayımlanır. Python 3.10+ gerektirir.

Bu belgeler, güncel kararlı sürüm hattı olan v2'yi anlatır:

uv add "mcp[cli]"

pip install "mcp[cli]"

v1'den mi geliyorsunuz?

v2, geriye dönük uyumsuz değişiklikler içeren bir ana sürümdür; Geçiş kılavuzu bunların her birini ele alır. Paketiniz mcp'ye bağımlıysa ve henüz geçişe hazır değilse, sabitlenmemiş bir çözümlemenin 1.x hattında kalması için <2 üst sınırını koruyun (örneğin mcp>=1.28,<2).

Neler kurulur

SDK'yı kullanmak için bunların hiçbirini bilmeniz gerekmez. Yine de her bağımlılığın ne işe yaradığını merak ediyorsanız:

  • mcp-types: tüm protokol türleri (istekler, sonuçlar, içerik blokları), SDK ile birebir aynı sürüm numarasıyla yayımlanan ayrı bir paket olarak gelir. mcp'ye bağımlı kod bunu mcp.types takma adı üzerinden içe aktarır (bu belgelerdeki her from mcp.types import ... satırı böyledir); mcp_types'ı doğrudan yalnızca mcp-types'ı SDK olmadan kuran bir projede içe aktarın.
  • anyio: asenkron çalışma zamanı. SDK'nın tamamı anyio üzerine yazıldığı için hem asyncio hem de trio üzerinde çalışır.
  • pydantic: her mcp.types modelinin temeli; ayrıca tüm şema üretimi ve doğrulaması.
  • httpx2: Streamable HTTP ve SSE istemci aktarımlarının arkasındaki HTTP istemcisi; server-sent events desteği yerleşik olarak gelir.
  • starlette, uvicorn, sse-starlette ve python-multipart: HTTP sunucu aktarımları.
  • jsonschema: bir aracın yapılandırılmış çıktısını, bildirdiği çıktı şemasına göre doğrular.
  • pyjwt[crypto]: yetkilendirme için OAuth token işleme.
  • opentelemetry-api: yalnızca hafif API; bu sayede siz bir OpenTelemetry SDK'sı ve dışa aktarıcı kurmadıkça SDK'nın izleme middleware'inin hiçbir maliyeti olmaz.
  • typing-extensions ve typing-inspection: Python 3.10'da modern tür özellikleri.
  • pywin32: yalnızca Windows'ta, stdio alt süreç yönetimi için kullanılır.

İsteğe bağlı ekler

  • mcp[cli], mcp komut satırı aracı (mcp dev, mcp run, mcp install) için typer ve python-dotenv paketlerini ekler. Geliştirme sırasında bunu istersiniz; dağıtılmış bir sunucuda gerekmeyebilir.
  • mcp[rich], daha okunaklı sunucu log'ları için rich paketini ekler.