Anatomi Pemanggilan JSON-RPC

Mari kita bedah satu pesan MCP nyata bidang demi bidang. Panggilan JSON-RPC adalah objek JSON kecil, dan empat kunci memuat seluruh maknanya.

Setiap pesan dimulai dengan jsonrpc yang diatur ke string 2.0. Penanda ini menunjukkan dialeknya agar kedua pihak menguraikan bagian lainnya dengan cara yang sama.

Id adalah angka atau string yang memberi label pada permintaan. Respons yang cocok mengulanginya, sehingga balasan tidak tertukar di antara banyak panggilan.

String method menyatakan hal yang Anda inginkan, seperti tools/call atau resources/read. MCP mengelompokkan method dengan garis miring, yaitu ruang nama sebelum kata kerja.

Objek params memuat argumen untuk method tersebut. Untuk panggilan alat, objek ini menyebutkan alat dan nilai yang harus diterimanya.

Gabungkan keempat kunci tersebut dan Anda memiliki permintaan lengkap. Permintaan ini meminta server menjalankan alat add dengan dua angka.

Beberapa method sama sekali tidak membutuhkan masukan. Jika demikian, Anda cukup menghilangkan params, seperti yang dilakukan tools/list saat hanya menginginkan seluruh katalog.

MCP selalu meneruskan params sebagai objek JSON dengan kunci bernama, bukan sebagai daftar tanpa nama. Nama membuat argumen dapat dipahami tanpa dokumentasi tambahan dan tidak bergantung pada urutan.

Balasan mencerminkan permintaan: jsonrpc sama, id sama, tetapi method dan params tidak ada. Sebagai gantinya, terdapat satu bidang hasil.

Dalam lalu lintas MCP, Anda terutama akan menemui tools/list, tools/call, resources/read, dan prompts/get. Kenali method-method ini dan maksudnya akan langsung terlihat.

Sekarang baris MCP apa pun dapat dibaca: jsonrpc adalah versinya, id memasangkan balasan, method adalah kata kerjanya, dan params adalah masukannya. Empat kunci, pemahaman yang lengkap.

Sekarang Anda dapat membaca panggilan apa pun: jsonrpc menetapkan versi, id memasangkan balasan, method menamai tindakan, dan params menyediakan masukannya. Itulah keseluruhan strukturnya.