Come funziona il trasporto stdio

Prima di collegare il server a qualcosa, deve sapere come comunica realmente. Il canale predefinito è stdio. 🔌

Il nome stdio indica semplicemente lo standard input e lo standard output: due flussi di testo che ogni programma ha già dal momento dell'avvio.

Con stdio, l'host avvia il server come processo figlio. Non ci sono porte né chiamate di rete: c'è solo un programma locale di sua proprietà.

Il client scrive i messaggi JSON-RPC nello stdin del server, mentre il server scrive le risposte tramite stdout.

Quasi mai dovrà avviare personalmente lo script. Indichi all'host un comando e sarà l'host a eseguirlo per avviare il server.

Poiché le risposte viaggiano su stdout, questo flusso è riservato al protocollo. Qualsiasi print imprevisto lo comprometterà e altererà il JSON atteso dal client.

Ha bisogno di annotazioni per sé? Le invii a stderr. L'host tratta stderr come un registro, così il debug non interferisce con il flusso dei messaggi.

Ogni connessione stdio è un collegamento privato: un client e un processo. Quando chiude il client, anche il processo del server termina.

stdio è ideale per il lavoro locale. Non richiede autenticazione, firewall o URL, quindi è il trasporto perfetto durante lo sviluppo. 💻

Il limite è che il server deve trovarsi sulla stessa macchina dell'host. Per raggiungere un server remoto, in seguito passerà al trasporto HTTP.

Ogni messaggio JSON-RPC occupa una singola riga che termina con un a capo. Questa struttura permette a entrambe le parti di suddividere il flusso in messaggi distinti e ordinati.

Ha visto come funziona stdio: l'host avvia il processo, comunica tramite stdin e stdout e conserva i log su stderr. Ora colleghiamolo a Claude. ✅