The STDIO transport

Studie-opmerkingen: MCP Communicatie en Transport

Kernconcepten

• Messages: Clients en servers communiceren door JSON-objecten uit te wisselen, die worden aangeduid als 'messages'.
• Transport: Dit is de methode die wordt gebruikt om JSON tussen client en server te verplaatsen (bijv. HTTP, WebSockets, Standard IO).

Standard IO Transport

• Werking: De client start de server als een apart proces.
• Communicatie:
• Client stuurt berichten naar de server door te schrijven naar de Standard In (stdin) van de server.
• De server stuurt antwoorden terug naar de client door te schrijven naar de Standard Out (stdout) van de client.
• Voordelen: Communicatie kan op elk moment door zowel de client als de server worden geïnitieerd.
• Nadelen: Vereist dat de client en de server op hetzelfde fysieke netwerk draaien.

Initialisatie van de Connectie (MCP Spec)

Om een verbinding met een MCP-server te initialiseren, moet de volgende drie stappen worden doorlopen:

• Client → Server: De client stuurt een initialized request.
• Server → Client: De server reageert met een initialized result.
• Client → Server: De client stuurt een initialized notification (dit vereist geen reactie).

• Nadat deze drie berichten zijn uitgewisseld, is de verbinding geïnitialiseerd.
• Vervolgens kunnen acties zoals call tool requests worden uitgevoerd.

Communicatie Scenario's

Er zijn vier basisscenario's voor communicatie tussen client en server:

• Client → Server: De client initieert een aanvraag (bijv. call tool request).
• Server → Client: De server stuurt een initiële aanvraag naar de client (bijv. voor sampling).
• Client → Server: De client reageert op een aanvraag van de server.
• Server → Client: De server stuurt een reactie op een aanvraag van de client.

**Vergelijking: Standard IO vs. Streamable HTTP**

• Standard IO: Is zeer flexibel; zowel de client als de server kunnen op elk moment een communicatie-initiatie (request) sturen en een reactie verwachten.
• Streamable HTTP: Heeft beperkingen; bepaalde scenario's, zoals het server initiëren van een initiële aanvraag naar de client, zijn mogelijk niet ondersteund.

Takeaways

• Communicatie tussen client en server vindt plaats door JSON-objecten uit te wisselen, aangeduid als 'messages'.
• Standard IO transport werkt door de client berichten naar de Standard In (stdin) van de server te schrijven en antwoorden via de Standard Out (stdout) te ontvangen.
• De verbinding moet worden geïnitialiseerd via een vaste drie-stappen reeks: initialized request (C→S), initialized result (S→C), en initialized notification (C→S).
• Standard IO is flexibeler dan Streamable HTTP omdat zowel de client als de server op elk moment een communicatie-initiatie kan sturen.