بروتوكول سياق النموذج في ADK-Rust
بروتوكول سياق النموذج (MCP) هو الحد الفاصل بين تطبيق الذكاء الاصطناعي وقدرة مملوكة بشكل منفصل. يمكن لخادم MCP نشر الأدوات والموارد القابلة للقراءة وقوالب المطالبات وإكمال الوسائط. يكتشف العميل هذا الكتالوج ويتواصل من خلال طرق البروتوكول المتفاوض عليها بدلاً من التكامل الخاص.
يستخدم ADK-Rust 2 أنواع rmcp 2.2 SDK و MCP 2025-11-25 الرسمية.
أين يتناسب ADK-Rust
Rendering architecture…
يقوم McpToolset بتكييف اتصال عميل MCP مهيأ واحد مع ADK-Rust. يمتلك McpServerManager سجلًا متغيرًا لعمليات stdio الفرعية المحلية ويجمع أدواتها. يمكن للتطبيقات التي تنشر القدرات بناء خوادم MCP باستخدام adk_tool::mcp::rmcp، وهو الإصدار SDK الدقيق الذي يستخدمه الإطار.
اختر السطح المناسب
| تحتاج إلى | استخدم | الملكية |
|---|---|---|
| ربط خادم محلي معروف واحد | McpToolset + TokioChildProcess | يبدأ التطبيق العملية الفرعية |
| ربط خدمة MCP بعيدة واحدة | McpHttpClientBuilder | يمتلك النشر البعيد التوفر |
| تغيير تعريفات الخادم المحلي في وقت التشغيل | McpServerManager | يمتلك التطبيق سجلًا محليًا وعمليات فرعية |
| نشر خادم MCP | adk_tool::mcp::rmcp | تمتلك خدمتك المخططات، والتفويض، والآثار الجانبية |
| الحفاظ على تكامل أخذ العينات المهمل يعمل | ميزة mcp-sampling | التوافق فقط بموجب SEP-2577 |
خريطة القدرات المطبقة
| القدرة | ADK-Rust API | السلوك |
|---|---|---|
| اكتشاف الأدوات واستدعاءاتها | McpToolset, Toolset | يتم الاحتفاظ بالمخططات الأولية والنتائج متعددة الوسائط |
| تصفية الأدوات | with_filter, with_tools | يرى النموذج الأدوات المحددة فقط |
| الموارد والقوالب | list_resources, list_resource_templates, read_resource | قراءة السياق من خلال URIs مستقر |
| المطالبات | list_prompts, get_prompt | حل الرسائل القابلة لإعادة الاستخدام والمملوكة للخادم |
| الإكمال | complete_prompt_argument, complete_resource_argument | طلب اقتراحات الوسائط من الخادم |
| اشتراكات الموارد | subscribe_resource, unsubscribe_resource | تتلقى المعالجات المخصصة إشعارات التحديث |
| استنباط | ElicitationHandler | أوضاع النموذج و URL |
| المهام | McpTaskConfig | إنشاء مهام استدعاء الأدوات المتفاوض عليها، الاستقصاء، النتائج، والإلغاء |
| HTTP قابلة للتدفق | McpHttpClientBuilder | مهل زمنية، رؤوس، حقن المصادقة، استعادة الجلسات المنتهية الصلاحية |
| سجل محلي ديناميكي | McpServerManager | إضافة، تحديث، تمكين، تعطيل، إزالة، حفظ، مراقبة، وإعادة تشغيل |
| عمل SDK متقدم | adk_tool::mcp::rmcp | معالجات الخادم، وسائل النقل، الإشعارات، وأنواع الامتدادات |
مسار التوثيق
- إنشاء عميل MCP
- إدارة خوادم MCP المحلية ديناميكيًا
- نشر خادم MCP
- الأمان والتفويض
- الاختبار والتحقق
- تسوية المخطط المدركة للموفر
حدود مهمة
- تستهدف الإدارة الديناميكية حاليًا عمليات stdio الفرعية المحلية.
- يكتشف مراقبة صحة المدير اتصال MCP مغلقًا. لا يثبت ذلك أن قاعدة بيانات الخادم أو API الخارجي سليم.
- يتم الاحتفاظ بـ
autoApproveللتكوين المتوافق؛ لا يفسر ADK-Rust ذلك كتفويض. - يقوم
OAuth2Configبإجراء طلب رمز مميز ثابت لبيانات اعتماد العميل. إنه ليس اكتشاف تفويض MCP الكامل وتدفق تفويض المتصفح. - تم إهمال أخذ العينات والجذور والتسجيل في المنبع من خلال SEP-2577.
هذه الحدود جزء من العقد العام ويجب أن تنعكس في تصميم النشر.