Der Streamable-HTTP-Transport

Der moderne Remote-Transport von MCP heißt Streamable HTTP. Damit kann Ihr Server hinter einer einzigen Web-URL bereitgestellt werden, die jeder Client im Internet erreichen kann.

Im Gegensatz zu älteren Entwürfen verwendet Streamable HTTP einen einzigen Endpunkt, häufig etwa /mcp. Sowohl Anfragen als auch Antworten laufen über diesen einen Pfad.

Um ein Tool aufzurufen, sendet der Client einen normalen HTTP-POST an den Endpunkt. Der Inhalt ist dieselbe JSON-RPC-Nachricht, die Sie bereits kennengelernt haben. 📨

Der Server kann auf zwei Arten antworten: mit einer einfachen JSON-Antwort für schnelle Aufrufe oder mit einem Ereignisstrom, wenn er Ergebnisse Stück für Stück senden möchte.

Der Accept-Header des Clients signalisiert, was dieser verarbeiten kann. Wenn sowohl JSON als auch der Ereignisstromtyp angegeben werden, kann der Server das beste Antwortformat auswählen.

Der Transport hat sich geändert, die Sprache jedoch nicht. Jede Nachricht über HTTP ist dieselbe JSON-RPC-Anfrage, -Antwort oder -Benachrichtigung, die Sie zuvor kennengelernt haben.

Mit dem Python SDK ändern Sie nur eine Einstellung: Führen Sie Ihren Server mit dem Transport streamable-http statt stdio aus. Die Tools bleiben exakt gleich.

Da es sich um gewöhnliches HTTP handelt, funktioniert es problemlos mit dem gesamten Web-Stack: Load Balancer, Proxys und TLS funktionieren ohne etwas Besonderes. 🌐

Streamable HTTP kann zustandsbehaftet ausgeführt werden und sich an eine Sitzung erinnern, oder zustandslos, wobei jeder Aufruf neu behandelt wird. Sie entscheiden anhand dessen, wie Ihr Server Kontext speichert.

Ein früherer HTTP+SSE-Entwurf verwendete zwei getrennte Pfade und war umständlicher. Streamable HTTP hat ihn als empfohlene Methode für die entfernte Bereitstellung von MCP ersetzt.

Dieser Entwurf mit einem einzigen Endpunkt macht einen entfernten MCP-Server praktisch bereitstellbar und für jeden Client von überall aus leicht erreichbar.

Streamable HTTP stellt MCP über einen einzigen HTTP-Endpunkt bereit: Clients senden JSON-RPC per POST, und der Server antwortet mit JSON oder einem laufenden Ereignisstrom. Dieselbe Logik, entfernte Erreichbarkeit. 🚀