mcp-log-proxy: proxy JSON-RPC stdio untuk alur kerja debugging MCP
mcp-log-proxy, oleh Emicklei, adalah utilitas pengembang lokal yang mengekspos komunikasi antara klien dan server MCP sehingga insinyur dapat memeriksa pertukaran protokol. Alat ini mencegat dan merekam pesan JSON-RPC yang dipertukarkan selama sesi MCP, menghasilkan jejak yang dapat dibaca untuk analisis dan pemecahan masalah. Elemen kunci termasuk proksi transparan, dukungan transportasi stdio, dan implementasi berbasis Go yang menjaga eksekusi tetap ringan. Ini ditujukan untuk insinyur perangkat lunak dan pengembang AI yang melakukan debug integrasi MCP di lingkungan desktop dan server lokal.
Anda dapat menangkap setiap pesan JSON-RPC tanpa mengubah alur protokol
mcp-log-proxy bertindak sebagai middleware transparan yang berada di antara klien dan server dan merekam lalu lintas pesan untuk inspeksi. Pengembang mendapatkan pandangan kronologis tentang permintaan, respons, notifikasi, dan panggilan alat, yang membantu memverifikasi format pesan dan struktur argumen. Proxy tidak mengubah logika protokol, sehingga jejak yang ditangkap mencerminkan interaksi yang tidak diubah antara klien MCP dan backend.
Logging paling cocok untuk koneksi MCP lokal berbasis stdio
Alat ini fokus pada lapisan transportasi stdio, yang merupakan transportasi lokal umum untuk implementasi MCP. Ini membuat logging dapat diandalkan untuk alur kerja desktop dan server lokal yang menggunakan input/output standar, sementara transportasi lainnya kurang ditekankan. Implementasi Go dijelaskan sebagai ringan, yang mendukung proxy dengan latensi rendah selama alur kerja pengembangan di mana responsivitas penting.
Instalasi dan integrasi cocok dengan alur kerja pengembang yang ada dengan perintah sederhana
Instalasi menggunakan toolchain Go dan satu perintah instalasi, memungkinkan pengaturan cepat untuk insinyur yang menggunakan Go. Integrasi adalah masalah menambahkan awalan pada perintah server dalam konfigurasi klien untuk mengarahkan lalu lintas melalui proxy. Penggunaan tipikal cocok dengan lingkungan pengujian lokal dan langkah CI yang menguji server MCP tanpa mengubah kode server.
File log lokal memberikan visibilitas sisi host tetapi memerlukan penanganan operasional
Secara default, proxy menulis log ke file lokal di direktori eksekusi, memberikan tim kontrol langsung atas data yang direkam di host. Ini menjaga jejak di mesin pengembang untuk inspeksi pribadi, namun juga menciptakan kebutuhan operasional untuk rotasi, pengarsipan, atau pengindeksan ketika sesi berjalan lama atau ketika beberapa kali menjalankan mengumpulkan file besar.
Alat praktis, pertama inspeksi untuk pengembangan MCP
mcp-log-proxy adalah opsi pragmatis bagi insinyur yang memerlukan jejak protokol yang dapat dibaca selama pengembangan dan pemecahan masalah MCP lokal. Desain pasifnya lebih mengutamakan inspeksi pasif daripada manipulasi protokol aktif, sehingga tim yang memerlukan injeksi pesan atau cakupan transportasi yang luas harus menggabungkannya dengan alat pelacakan pelengkap. Untuk analisis yang lebih cepat, alirkan log ke dalam pager atau pengindeks yang sadar JSON untuk mencari dan menyaring jejak besar dengan efisien.
Kelebihan
Menangkap pesan JSON-RPC masuk dan keluar untuk inspeksi
Dibangun untuk transportasi stdio yang digunakan oleh server MCP lokal
Implementasi Go menjaga overhead runtime tetap rendah selama pemrosesan proxy.
Dapat dimasukkan dengan menambahkan perintah server di konfigurasi klien
Kelemahan
Fokus utama pada batasan stdio berguna untuk SSE atau transportasi jarak jauh
Desain proxy pasif mencegah injeksi pesan aktif untuk pengujian
Logging file tunggal default memerlukan rotasi atau arsip manual
Hukum terkait penggunaan perangkat lunak ini berbeda di tiap negara. Kami tidak mendorong atau membenarkan penggunaan program ini jika melanggar hukum. Softonic mungkin menerima biaya rujukan jika Anda mengeklik atau membeli produk yang ditampilkan di sini.
