Zum Inhalt

Installation

Maschinelle Übersetzung

Diese Seite wurde automatisch aus der englischen Dokumentation übersetzt, und die englische Seite ist die maßgebliche Fassung. Wenn sich etwas falsch liest, erklärt Übersetzungen, wie du es melden kannst.

Das Python-SDK liegt auf PyPI als mcp. Es setzt Python 3.10+ voraus.

Diese Dokumentation beschreibt v2, die aktuelle stabile Release-Linie:

uv add "mcp[cli]"

pip install "mcp[cli]"

Umstieg von v1?

v2 ist eine Hauptversion mit inkompatiblen Änderungen; der Migrationsleitfaden behandelt jede einzelne davon. Wenn dein Paket von mcp abhängt und noch nicht bereit für die Migration ist, behalte eine Obergrenze <2 bei (zum Beispiel mcp>=1.28,<2), damit eine nicht gepinnte Auflösung auf der 1.x-Linie bleibt.

Was installiert wird

Nichts davon musst du wissen, um das SDK zu nutzen. Falls du dich aber fragst, wozu die einzelnen Abhängigkeiten da sind:

  • mcp-types: jeder Protokolltyp (Requests, Ergebnisse, Content-Blöcke) als eigenes Paket, im Gleichschritt mit dem SDK versioniert. Code, der von mcp abhängt, importiert es über den Alias mcp.types (jedes from mcp.types import ... in dieser Dokumentation); importiere mcp_types nur in einem Projekt direkt, das mcp-types ohne das SDK installiert.
  • anyio: die asynchrone Laufzeit. Das gesamte SDK ist gegen anyio geschrieben und läuft daher sowohl auf asyncio als auch auf trio.
  • pydantic: die Grundlage jedes mcp.types-Modells, dazu die gesamte Schema-Generierung und Validierung.
  • httpx2: der HTTP-Client hinter den Client-Transporten für Streamable HTTP und SSE, mit eingebauter Unterstützung für Server-Sent Events.
  • starlette, uvicorn, sse-starlette und python-multipart: die Server-Transporte für HTTP.
  • jsonschema: validiert die strukturierte Ausgabe eines Tools gegen das deklarierte Output-Schema.
  • pyjwt[crypto]: Verarbeitung von OAuth-Tokens für die Autorisierung.
  • opentelemetry-api: nur die schlanke API. Die Tracing-Middleware des SDK kostet also nichts, solange du nicht selbst ein OpenTelemetry-SDK samt Exporter installierst.
  • typing-extensions und typing-inspection: moderne Typing-Features auf Python 3.10.
  • pywin32: nur unter Windows, für die Verwaltung von stdio-Subprozessen.

Optionale Extras

  • mcp[cli] ergänzt typer und python-dotenv für das Kommandozeilen-Tool mcp (mcp dev, mcp run, mcp install). Während der Entwicklung wirst du das haben wollen; in einem bereitgestellten Server brauchst du es womöglich nicht.
  • mcp[rich] ergänzt rich für schönere Server-Logs.