Menegosiasikan Kemampuan

MCP kaya akan fitur, tetapi tidak ada klien atau peladen yang mendukung semuanya. Karena itu, saat memulai, kedua pihak menegosiasikan fitur yang mereka miliki, seperti dua perangkat yang menyepakati kemampuan masing-masing. 🤝

Kesepakatan ini dibuat selama jabat tangan inisialisasi, yaitu pertukaran pertama. Setelah itu, setiap pihak mengetahui apa yang ditawarkan pihak lain dan apa yang tidak tersedia.

Klien mengumumkan clientCapabilities-nya dan peladen mengumumkan serverCapabilities-nya. Setiap kumpulan hanyalah peta penanda fitur dan opsi kecil.

Peladen mencantumkan hal-hal yang disediakannya, seperti alat, sumber daya, dan prompt. Jika sebuah kunci tidak ada, klien tahu untuk tidak mengharapkan kemampuan dasar tersebut dari Anda.

Klien mencantumkan fitur yang dapat ditawarkannya, seperti akar, pengambilan sampel, dan elisitasi. Dengan begitu, peladen Anda mengetahui bahwa peladen bahkan boleh meminta akar.

Sebuah kemampuan dapat memuat opsi tambahan. Misalnya, akar dapat membawa listChanged: true, yang berarti klien akan memberi tahu Anda saat kumpulan akarnya berubah.

Aturannya sederhana: jika sebuah kemampuan tidak ada, anggap fitur tersebut tidak tersedia. Jangan pernah memanggil sesuatu yang tidak pernah dijanjikan pihak lain dapat dilakukannya.

Bersama fitur, kedua pihak mengirim protocolVersion. Mereka harus menyepakati versi yang sama, atau sesi ditolak sebelum pekerjaan sebenarnya dimulai.

Anda jarang perlu membuat peta ini secara manual. SDK Python melengkapi kemampuan peladen Anda berdasarkan alat dan sumber daya yang didaftarkan, lalu mempertukarkannya untuk Anda.

Setelah inisialisasi, Anda dapat memeriksa kemampuan klien yang ditangkap sesi Anda. Pemeriksaan inilah yang melindungi pemanggilan opsional seperti list_roots.

Kemampuan ditetapkan saat memulai dan berlaku untuk sesi. Anda dapat mengandalkannya selama masa koneksi tanpa menegosiasikannya ulang pada setiap pemanggilan.

Saat inisialisasi, klien dan peladen saling menukar peta kemampuan serta versi protokol. Penanda yang tidak ada berarti tidak didukung, dan SDK membuat serta membacanya untuk Anda. 🎯