Công cụ qua MCP (Model Context Protocol)
Một khi ứng dụng của bạn có nhiều hơn một công cụ, mỗi nhà cung cấp mô hình lại tự nghĩ ra hình dạng JSON riêng để gọi chúng, và bạn kết cục phải viết một bộ chuyển đổi cho mỗi nhà cung cấp. Model Context Protocol (MCP) là tiêu chuẩn mở sửa điều này. Nó là một giao thức truyền tin JSON-RPC 2.0 để phơi ra công cụ (các hàm mô hình có thể gọi), tài nguyên (dữ liệu nó có thể đọc), và prompt cho bất kỳ client mô hình nào. Viết một máy chủ MCP một lần và bất kỳ client hiểu MCP nào (một trợ lý trong IDE, một ứng dụng desktop, một agent) đều dùng được nó.
Mỗi thông điệp là JSON-RPC 2.0, một phong bì nhỏ, cố định. Một yêu cầu luôn mang bốn khóa:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}id nối một câu trả lời lại với yêu cầu của nó. Máy chủ trả lời bằng một phản hồi lặp lại cùng id và mang hoặc một result hoặc một đối tượng error, không bao giờ cả hai:
{"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"}}Các mã âm là JSON-RPC chuẩn: -32601 là "method not found", -32602 là "invalid params", và vân vân. Một kết quả tools/call luôn có hình dạng đó: một list content gồm các khối (văn bản, hình ảnh, v.v.) cộng isError. Một công cụ đã chạy nhưng thất bại (giả sử một tên thành phố sai) trả lời bằng isError: true trong một kết quả bình thường, để mô hình đọc được lỗi; đối tượng error của JSON-RPC là dành cho các vấn đề giao thức như một phương thức không xác định.
Một phiên bắt đầu bằng một cái bắt tay: client gửi một yêu cầu initialize (phiên bản giao thức, các khả năng và tên của nó), máy chủ trả lời bằng các khả năng của riêng nó, và client xác nhận bằng một thông báo notifications/initialized (một thông điệp không có id, vì không ai trả lời nó). Chỉ khi đó client mới khám phá các công cụ bằng cách gọi tools/list với params rỗng; máy chủ trả về list các mô tả công cụ.
Một máy chủ MCP thật chạy qua stdio hoặc HTTP và nối điều này vào SDK; ở đây ta tạo và phân tích các thông điệp bằng mô-đun json của thư viện chuẩn để định dạng truyền tin trở nên cụ thể. Bạn đang viết ba hàm.
build_request(id, method, params)-> một chuỗi JSON cho phong bì{"jsonrpc": "2.0", "id": id, "method": method, "params": params}. Dùngjson.dumps.parse_response(text)->json.loadsvăn bản, yêu cầujsonrpc == "2.0"(báoValueErrornếu không). Nếu nó có mộtresult, trả về{"id": ..., "ok": True, "result": ...}. Nếu nó có mộterror, trả về{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. Nếu nó không có cái nào, báoValueError.list_tools_request(id)-> yêu cầu khám phá công cụ: mộtbuild_requestvới phương thức"tools/list"vàparamsrỗng{}.
Vì build_request trả về một chuỗi, các bài kiểm tra phân tích nó lại bằng json.loads và so sánh dict, nên thứ tự khóa không quan trọng. Đảm bảo cả một kết quả lẫn một lỗi đều khứ hồi được, yêu cầu khám phá có đúng phương thức, và một thông điệp thiếu jsonrpc hoặc không có cả result lẫn error thì báo lỗi.
Tạo và phân tích các thông điệp JSON-RPC 2.0 kiểu MCP bằng mô-đun json. build_request(id, method, params) trả về chuỗi JSON cho {"jsonrpc": "2.0", "id", "method", "params"}. parse_response(text) nạp văn bản, yêu cầu jsonrpc == "2.0" (nếu không thì báo ValueError), và trả về {"id", "ok": True, "result"} cho một kết quả hoặc {"id", "ok": False, "error": {"code", "message"}} cho một lỗi, báo lỗi nếu nó không có cái nào. list_tools_request(id) trả về yêu cầu khám phá tools/list (gửi sau cái bắt tay) với params rỗng.
Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này
Bài tập này sẽ sớm mở.
Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.
Trình duyệt này đang chặn cookie cho learn.floati.life, nên các bài học bạn đã hoàn thành tại đây không thể mở theo thứ tự. Hãy cho phép cookie cho trang web này và tải lại trang.