Logging Terstruktur ke Klien

Mencetak ke terminal Anda hanya membantu Anda. MCP memungkinkan server mengirim pesan log melalui protokol sehingga aplikasi host juga dapat menampilkannya.

Log dikirim sebagai notifikasi notifications/message. Notifikasi ini memuat level, nama pencatat opsional, dan data yang ingin Anda catat.

Dari dalam tool, Anda mengakses logging melalui objek Context, yaitu pegangan yang sama dengan yang digunakan untuk progres. Tidak diperlukan penyiapan tambahan.

Helper yang paling umum adalah ctx.info. Gunakan untuk catatan status normal dan yang diharapkan, agar pengguna dapat mengikuti pekerjaan tool.

Gunakan ctx.debug saat Anda menginginkan jejak terperinci, seperti nilai yang telah diurai atau cabang yang dipilih, yang terlalu ramai untuk penggunaan sehari-hari.

Gunakan ctx.warning saat terjadi sesuatu yang tidak sesuai tetapi masih dapat dipulihkan, seperti kolom opsional yang hilang lalu Anda isi dengan nilai bawaan.

Panggil ctx.error untuk masalah yang nyata. Ini memberi tahu klien bahwa suatu langkah gagal, terpisah dari pengajuan pengecualian yang mengakhiri pemanggilan.

MCP mengikuti skala syslog yang umum: debug, info, notice, warning, error, critical, dan level yang lebih tinggi. Klien dapat mengurutkan dan memberi warna berdasarkan level.

Banyak helper menerima nama logger agar pesan dapat dikelompokkan berdasarkan komponen, mirip dengan modul logging standar Python.

Pesan log meninggalkan proses Anda dan mencapai klien, jadi perlakukan pesan tersebut sebagai sesuatu yang dapat dilihat. Jangan pernah menulis rahasia seperti token atau kata sandi ke dalam log.

Seperti progres, setiap log adalah notifikasi, sehingga tidak pernah memblokir tool Anda atau mengharapkan balasan. Anda dapat mencatat dengan bebas selama pekerjaan berlangsung.

Pilih helper yang tepat untuk pembaruan status rutin.

Sekarang Anda dapat menghasilkan log berlevel dengan ctx.info, debug, warning, dan error, memberi nama logger, serta menjauhkan rahasia dari log. Kemajuan yang bagus!