Cara Kerja Transportasi stdio

Sebelum menghubungkan server Anda ke apa pun, Anda perlu mengetahui cara server benar-benar berkomunikasi. Saluran bawaan adalah stdio. 🔌

Nama stdio hanyalah gabungan input standar dan output standar: dua aliran teks yang sudah dimiliki setiap program sejak mulai berjalan.

Dengan stdio, host menjalankan server Anda sebagai proses anak. Tidak ada port dan tidak ada panggilan jaringan, hanya program lokal yang dikelola host.

Klien menulis pesan JSON-RPC ke stdin server Anda, lalu server menulis balasannya kembali melalui stdout.

Anda hampir tidak pernah memulai skrip sendiri. Anda memberi tahu host sebuah perintah, lalu host menjalankan perintah itu untuk menghidupkan server Anda.

Karena balasan dikirim melalui stdout, aliran tersebut dicadangkan untuk protokol. print apa pun yang terselip di sana akan mengacaukan JSON yang diharapkan klien.

Perlu meninggalkan catatan untuk diri sendiri? Kirimkan ke stderr. Host memperlakukan stderr sebagai catatan, sehingga proses debug Anda tidak menyentuh aliran pesan.

Setiap koneksi stdio adalah tautan pribadi: satu klien, satu proses. Tutup klien, dan proses server Anda akan ikut dimatikan.

stdio sangat berguna untuk pekerjaan lokal. stdio tidak memerlukan autentikasi, firewall, atau URL, sehingga menjadi transportasi yang sempurna saat Anda mengembangkan. 💻

Kekurangannya: server harus berada di mesin yang sama dengan host. Untuk menjangkau server secara jarak jauh, nanti Anda akan beralih ke transportasi HTTP.

Setiap pesan JSON-RPC adalah satu baris yang diakhiri baris baru. Pembingkaian ini memungkinkan kedua sisi memisahkan aliran menjadi pesan-pesan terpisah yang rapi.

Anda telah melihat cara kerja stdio: host menjalankan proses Anda, berkomunikasi melalui stdin dan stdout, serta menyimpan catatan di stderr. Sekarang mari hubungkan ke Claude. ✅