mcp-log-proxy: stdio JSON-RPC โปรxies สำหรับการดีบัก MCP workflows
mcp-log-proxy, โดย Emicklei, เป็นเครื่องมือสำหรับนักพัฒนาท้องถิ่นที่เปิดเผยการสื่อสารระหว่างลูกค้า MCP และเซิร์ฟเวอร์เพื่อให้นักวิศวกรสามารถตรวจสอบการแลกเปลี่ยนโปรโตคอล เครื่องมือนี้จะดักจับและบันทึกข้อความ JSON-RPC ที่แลกเปลี่ยนระหว่างเซสชัน MCP สร้างการติดตามที่อ่านได้สำหรับการวิเคราะห์และการแก้ไขปัญหา องค์ประกอบหลักประกอบด้วยการทำงานเป็นพร็อกซี่ที่โปร่งใส, การสนับสนุนการขนส่ง stdio, และการใช้งานที่สร้างจาก Go ซึ่งทำให้การดำเนินการมีน้ำหนักเบา มันมุ่งเป้าไปที่วิศวกรซอฟต์แวร์และนักพัฒนา AI ที่กำลังแก้ไขปัญหาการรวม MCP ในสภาพแวดล้อมเซิร์ฟเวอร์ท้องถิ่นและเดสก์ท็อป。
คุณสามารถจับข้อความ JSON-RPC ทุกข้อความโดยไม่เปลี่ยนแปลงการไหลของโปรโตคอล
mcp-log-proxy ทำหน้าที่เป็น middleware ที่โปร่งใส ซึ่งนั่งอยู่ระหว่างไคลเอนต์และเซิร์ฟเวอร์และบันทึกการจราจรของข้อความเพื่อการตรวจสอบ นักพัฒนาจะได้มุมมองตามลำดับเวลาเกี่ยวกับคำขอ คำตอบ การแจ้งเตือน และการเรียกเครื่องมือ ซึ่งช่วยในการตรวจสอบรูปแบบข้อความและโครงสร้างอาร์กิวเมนต์ โปรxies จะไม่เปลี่ยนแปลงตรรกะของโปรโตคอล ดังนั้นการติดตามที่จับได้จึงสะท้อนถึงการโต้ตอบที่ไม่เปลี่ยนแปลงระหว่างไคลเอนต์ MCP และแบ็กเอนด์
การบันทึกเหมาะสำหรับการเชื่อมต่อ MCP แบบท้องถิ่นที่ใช้ stdio
เครื่องมือมุ่งเน้นไปที่เลเยอร์การขนส่ง stdio ซึ่งเป็นการขนส่งท้องถิ่นทั่วไปสำหรับการใช้งาน MCP สิ่งนี้ทำให้การบันทึกเชื่อถือได้สำหรับการทำงานของเดสก์ท็อปและเซิร์ฟเวอร์ท้องถิ่นที่ใช้การป้อนข้อมูล/เอาต์พุตมาตรฐาน ในขณะที่การขนส่งอื่น ๆ จะได้รับความสำคัญน้อยลง การใช้งาน Go ถูกอธิบายว่าเบา ซึ่งสนับสนุนการทำ proxy ที่มีความหน่วงต่ำในระหว่างการทำงานพัฒนาที่ความรวดเร็วสำคัญ
การติดตั้งและการรวมเข้ากับการทำงานของนักพัฒนาที่มีอยู่ด้วยคำสั่งที่ง่าย
การติดตั้งใช้ชุดเครื่องมือ Go และคำสั่งติดตั้งเพียงคำสั่งเดียว ทำให้การตั้งค่าเร็วขึ้นสำหรับวิศวกรที่ใช้ Go การรวมเข้ากับการทำงานเป็นเรื่องของการเติมคำสั่งเซิร์ฟเวอร์ในการกำหนดค่าของไคลเอนต์เพื่อจัดการการจราจรผ่าน proxy การใช้งานทั่วไปเหมาะสำหรับสภาพแวดล้อมการทดสอบท้องถิ่นและขั้นตอน CI ที่ทดสอบเซิร์ฟเวอร์ MCP โดยไม่เปลี่ยนแปลงโค้ดเซิร์ฟเวอร์
ไฟล์บันทึกท้องถิ่นให้การมองเห็นด้านโฮสต์แต่ต้องการการจัดการการดำเนินงาน
ตามค่าเริ่มต้น proxy จะเขียนบันทึกลงในไฟล์ท้องถิ่นในไดเรกทอรีการดำเนินการ ทำให้ทีมมีการควบคุมโดยตรงเกี่ยวกับข้อมูลที่บันทึกไว้บนโฮสต์ สิ่งนี้ทำให้การติดตามอยู่บนเครื่องของนักพัฒนาเพื่อการตรวจสอบส่วนตัว อย่างไรก็ตามมันยังสร้างความจำเป็นในการดำเนินงานสำหรับการหมุนเวียน การเก็บถาวร หรือการจัดทำดัชนีเมื่อเซสชันดำเนินการนานหรือเมื่อการทำงานหลายครั้งสะสมไฟล์ขนาดใหญ่
เครื่องมือที่ใช้งานได้จริงสำหรับการพัฒนา MCP โดยเน้นการตรวจสอบเป็นอันดับแรก
mcp-log-proxy เป็นตัวเลือกที่มีเหตุผลสำหรับวิศวกรที่ต้องการการติดตามโปรโตคอลที่อ่านได้ในระหว่างการพัฒนาและการแก้ไขปัญหา MCP ในท้องถิ่น การออกแบบแบบพาสซีฟของมันสนับสนุนการตรวจสอบแบบพาสซีฟมากกว่าการจัดการโปรโตคอลแบบแอคทีฟ ดังนั้นทีมที่ต้องการการฉีดข้อความหรือการครอบคลุมการขนส่งที่กว้างขวางควรใช้ร่วมกับเครื่องมือการติดตามที่เสริมกัน สำหรับการวิเคราะห์ที่รวดเร็ว ให้ส่งบันทึกไปยังตัวจัดการหรือดัชนีที่รับรู้ JSON เพื่อค้นหาและกรองการติดตามขนาดใหญ่ได้อย่างมีประสิทธิภาพ.
