Silabus Pelajaran 139 dari 250 · Output Terstruktur & Pemanggilan Fungsi/Tool
Output Terstruktur & Pemanggilan Fungsi/Tool

Alat di atas MCP (Model Context Protocol)

Setelah aplikasimu punya lebih dari satu tool, setiap vendor model membuat bentuk JSON sendiri untuk memanggilnya, dan kamu akhirnya harus menulis adapter untuk setiap provider. Model Context Protocol (MCP) adalah standar terbuka yang memperbaiki ini. Ini adalah protokol wire JSON-RPC 2.0 untuk mengekspos tools (fungsi yang bisa dipanggil model), resources (data yang bisa dibaca), dan prompts ke klien model mana pun. Tulis server MCP sekali dan klien yang sadar MCP (asisten IDE, aplikasi desktop, agen) bisa menggunakannya.

Setiap pesan adalah JSON-RPC 2.0, yang merupakan amplop kecil dan tetap. Sebuah request selalu membawa empat kunci:

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "add", "arguments": {"a": 2, "b": 3}}}

id menghubungkan balasan ke permintaannya. Server menjawab dengan response yang mengulang id yang sama dan membawa either sebuah result or sebuah error objek, tidak keduanya:

{"jsonrpc": "2.0", "id": 1, "result": {"content": [{"type": "text", "text": "5"}], "isError": false}}
{"jsonrpc": "2.0", "id": 1, "error": {"code": -32601, "message": "Method not found"}}

Kode negatif adalah JSON-RPC standar: -32601 adalah "method not found", -32602 adalah "invalid params", dan seterusnya. Hasil tools/call selalu punya bentuk itu: daftar content blok (teks, gambar, dan lainnya) ditambah isError. Alat yang berjalan tapi gagal (nama kota yang salah, misalnya) menjawab dengan isError: true dalam hasil normal, jadi model bisa membaca kegagalannya; objek JSON-RPC error adalah untuk masalah protokol seperti metode yang tidak dikenal.

Sesi

A dimulai dengan handshake: klien mengirim initialize request (versi protokol, kemampuan, dan namanya), server menjawab dengan kemampuannya sendiri, dan klien mengonfirmasi dengan notifications/initialized notification (pesan tanpa id, karena tidak ada yang membalasnya). Baru setelah itu klien discover alat dengan memanggil tools/list dengan params kosong; server mengembalikan daftar deskriptor alat.

server MCP asli berjalan di atas stdio atau HTTP dan menghubungkannya ke SDK; di sini kita membangun dan membedah pesan dengan modul json standar agar format pengirimannya konkret. Kamu menulis tiga fungsi.

  • build_request(id, method, params) -> sebuah string untuk amplop {"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Gunakan json.dumps.
  • parse_response(text) -> json.loads teksnya, butuh jsonrpc == "2.0" (lemparkan ValueError jika tidak). Jika ada result, kembalikan {"id": ..., "ok": True, "result": ...}. Jika ada error, kembalikan {"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. Jika tidak ada keduanya, lemparkan ValueError.
  • list_tools_request(id) -> permintaan penemuan alat: sebuah build_request dengan method "tools/list" dan params {}.
  • kosong

Karena build_request mengembalikan string, tes akan memparsingnya kembali dengan json.loads dan membandingkan dict, jadi urutan key tidak masalah. Pastikan hasil dan error keduanya bisa round-trip, request discovery punya method yang benar, dan pesan yang kekurangan jsonrpc atau tidak punya result maupun error memicu error.

Giliranku

Bangun dan parsing pesan JSON-RPC 2.0 gaya MCP dengan modul json. build_request(id, method, params) mengembalikan string JSON untuk {"jsonrpc": "2.0", "id", "method", "params"}. parse_response(text) memuat teks, butuh jsonrpc == "2.0" (kalau tidak lempar ValueError), dan mengembalikan {"id", "ok": True, "result"} untuk hasil atau {"id", "ok": False, "error": {"code", "message"}} untuk error, lempar jika tidak punya keduanya. list_tools_request(id) mengembalikan permintaan penemuan tools/list (dikirim setelah handshake) dengan params kosong.

Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini

Latihan ini akan segera dibuka

Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.