الأدوات عبر MCP (Model Context Protocol)
بمجرد أن يحتوي تطبيقك على أكثر من أداة واحدة، يقوم كل مزود نموذج بابتكار شكل JSON خاص به لاستدعائها، وينتهي بك الأمر بكتابة adapter لكل مزود. بروتوكول سياق النموذج (MCP) هو المعيار المفتوح الذي يحل هذه المشكلة. إنه بروتوكول JSON-RPC 2.0 سلكي للكشف عن الأدوات (الوظائف التي يمكن للنموذج استدعاؤها)، والموارد (البيانات التي يمكنه قراءتها)، والمطالبات لأي عميل نموذج. اكتب خادم MCP مرة واحدة ويمكن لأي عميل يدعم MCP (مساعد IDE، أو تطبيق سطح مكتب، أو agent) استخدامه.
كل رسالة هي JSON-RPC 2.0، وهي غلاف صغير وثابت. طلب request يحمل دائما أربعة مفاتيح:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "add", "arguments": {"a": 2, "b": 3}}}يربط id الرد بطلبه. يجيب الخادم بـ response يعكس نفس id ويحمل either إما result or كائن error، وليس كلاهما أبدا:
{"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"}} الأكواد السالبة هي JSON-RPC قياسية: -32601 تعني "method not found"، و-32602 تعني "invalid params"، وهكذا. نتيجة tools/call لها دائماً هذا الشكل: قائمة content من blocks (نصوص، صور، وما إلى ذلك) بالإضافة إلى isError. الأداة التي تعمل ولكنها تفشل (اسم مدينة خاطئ، مثلاً) تجيب بـ isError: true في النتيجة العادية، لكي يتمكن النموذج من قراءة الفشل؛ كائن JSON-RPC error مخصص لمشاكل البروتوكول مثل method غير معروف.
بـ handshake: يرسل العميل initialize request (إصدار البروتوكول الخاص به، وقدراته، واسمه)، ويجيب الخادم بقدراته الخاصة، ويؤكد العميل ذلك بـ notifications/initialized notification (رسالة بدون id، لأنه لا أحد يرد عليها). عندها فقط يقوم العميل discover بالأدوات عن طريق استدعاء tools/list بمعاملات فارغة؛ يعيد الخادم قائمة واصفات الأدوات.
يعمل خادم MCP حقيقي عبر stdio أو HTTP ويربط هذا بالـ SDK؛ هنا نبني الرسائل ونحلّلها بوحدة json من المكتبة القياسية لكي يكون تنسيق النقل ملموساً. ستكتب ثلاث دوال.
build_request(id, method, params)-> سلسلة string للظرف{"jsonrpc": "2.0", "id": id, "method": method, "params": params}. استخدمjson.dumps.parse_response(text)->json.loadsالنص، يتطلبjsonrpc == "2.0"(ارفعValueErrorخلاف ذلك). إذا كان يحتوي علىresult، أرجع{"id": ..., "ok": True, "result": ...}. إذا كان يحتوي علىerror، أرجع{"id": ..., "ok": False, "error": {"code": ..., "message": ...}}. إذا لم يحتوي على أي منهما، ارفعValueError.list_tools_request(id)-> طلب اكتشاف الأداة:build_requestمع method"tools/list"وparams{}. فارغ.
بما أن build_request تعيد string، فإن الاختبارات تقوم بتحليلها مرة أخرى باستخدام json.loads وتقارن الـ dict، لذا فإن ترتيب المفاتيح لا يهم. تأكد من أن النتيجة والخطأ كلاهما يمران عبر عملية التحويل ذهابا وإيابا، وأن طلب discovery يحتوي على الطريقة الصحيحة، وأن الرسالة التي تفتقر إلى jsonrpc أو لا تحتوي على result ولا error ترفع خطأ.
قم ببناء وتحليل رسائل JSON-RPC 2.0 بنمط MCP باستخدام وحدة json. تعيد build_request(id, method, params) سلسلة JSON الخاصة بـ {"jsonrpc": "2.0", "id", "method", "params"}. تقوم parse_response(text) بتحميل النص، وتتطلب jsonrpc == "2.0" (وإلا ترفع ValueError)، وتعيد {"id", "ok": True, "result"} للنتيجة أو {"id", "ok": False, "error": {"code", "message"}} للخطأ، وترفع استثناءً إذا لم تملك أياً منهما. تعيد list_tools_request(id) طلب اكتشاف tools/list (المرسل بعد المصافحة) مع params فارغة.
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.