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.
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}. Gunakanjson.dumps.parse_response(text)->json.loadsteksnya, butuhjsonrpc == "2.0"(lemparkanValueErrorjika tidak). Jika adaresult, kembalikan{"id": ..., "ok": True, "result": ...}. Jika adaerror, kembalikan{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. Jika tidak ada keduanya, lemparkanValueError.list_tools_request(id)-> permintaan penemuan alat: sebuahbuild_requestdengan method"tools/list"danparams{}. 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.
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.
Browser ini memblokir cookie untuk learn.floati.life, jadi pelajaran yang sudah kamu selesaikan di sini tidak bisa dibuka berurutan. Izinkan cookie untuk situs ini dan muat ulang.