การทำงานของการส่งข้อมูลด้วย stdio

ก่อนเชื่อมต่อเซิร์ฟเวอร์ของคุณเข้ากับสิ่งใด คุณต้องรู้ก่อนว่าเซิร์ฟเวอร์สื่อสารจริงอย่างไร ช่องทางเริ่มต้นคือ stdio 🔌

ชื่อ stdio เป็นเพียงอินพุตมาตรฐานรวมกับเอาต์พุตมาตรฐาน ซึ่งเป็นสตรีมข้อความสองรายการที่ทุกโปรแกรมมีอยู่แล้วตั้งแต่เริ่มทำงาน

เมื่อใช้ stdio โฮสต์จะเปิดใช้เซิร์ฟเวอร์ของคุณเป็นโปรเซสลูก ไม่มีพอร์ตและไม่มีการเรียกผ่านเครือข่าย มีเพียงโปรแกรมภายในเครื่องที่โฮสต์เป็นผู้ดูแล

ไคลเอนต์เขียนข้อความ JSON-RPC ไปยัง อินพุตมาตรฐานของโปรเซสเซิร์ฟเวอร์ และเซิร์ฟเวอร์จะเขียนคำตอบกลับผ่านเอาต์พุตมาตรฐาน

โดยปกติคุณแทบไม่ต้องเริ่มสคริปต์ด้วยตนเอง เพียงบอกคำสั่งแก่โฮสต์ แล้วโฮสต์จะเรียกใช้คำสั่งนั้นเพื่อเริ่มเซิร์ฟเวอร์ของคุณ

เนื่องจากคำตอบเดินทางผ่านเอาต์พุตมาตรฐาน สตรีมนี้จึงสงวนไว้สำหรับโพรโทคอล การใช้ print ที่ไม่เกี่ยวข้องในสตรีมนี้จะทำให้ JSON ที่ไคลเอนต์คาดหวังเสียหาย

ต้องการจดบันทึกไว้ดูเองหรือไม่ ให้ส่งบันทึกไปยังข้อผิดพลาดมาตรฐาน โฮสต์จะถือว่าสตรีมนี้เป็นบันทึก ดังนั้นข้อมูลสำหรับแก้ไขข้อบกพร่องจะไม่ปะปนกับสตรีมข้อความ

การเชื่อมต่อ stdio แต่ละรายการเป็นลิงก์ส่วนตัว: ไคลเอนต์หนึ่งตัวต่อหนึ่งโปรเซส เมื่อปิดไคลเอนต์ โปรเซสเซิร์ฟเวอร์ของคุณก็จะปิดลงตามไปด้วย

stdio เหมาะอย่างยิ่งกับการทำงานภายในเครื่อง ไม่ต้องใช้การยืนยันตัวตน ไฟร์วอลล์ หรือ URL จึงเหมาะสำหรับช่วงที่คุณพัฒนา 💻

ข้อจำกัดคือเซิร์ฟเวอร์ต้องอยู่บนเครื่องเดียวกับโฮสต์ หากต้องการเข้าถึงเซิร์ฟเวอร์จากระยะไกล ภายหลังคุณจะเปลี่ยนไปใช้การส่งผ่าน HTTP

ข้อความ JSON-RPC แต่ละรายการจะอยู่ในบรรทัดเดียวและลงท้ายด้วยการขึ้นบรรทัดใหม่ การจัดกรอบเช่นนี้ช่วยให้ทั้งสองฝั่งแบ่งสตรีมออกเป็นข้อความแยกกันได้อย่างชัดเจน

คุณได้เห็นแล้วว่า stdio ทำงานอย่างไร: โฮสต์สร้างโปรเซสของคุณ สื่อสารผ่านอินพุตและเอาต์พุตมาตรฐาน และเก็บบันทึกไว้ในข้อผิดพลาดมาตรฐาน ตอนนี้มาเชื่อมต่อกับ Claude กัน ✅