وصل عميل Google بلغة Java لـ MCP Toolbox for Databases إلى الإصدار 1.0.0 في 9 سبتمبر. وفي إعلانصدر في 6 أكتوبر، فصّلت الشركة تغييرات النقل والمصادقة ومعلمات الأدوات للفرق التي تربط تطبيقات Java بخادم Toolbox يعمل على نحو منفصل. ويؤرخ سجل الإصدار نشر الشفرة قبل ذلك الإعلان بنحو شهر.

هذا الفرق مهم لفريق Java يقرر ما إذا كان سيعتمد العميل الآن. تصف Google الإصدار 1.0 بأنه أساس مستقر ومتوافق مع الإصدارات السابقة، لكن سجل الإصدار نفسه يذكر تغييراً غير متوافق: تُحذف المعلمات المرتبطة من تعريف الأداة المعروض على الوكيل. ينبغي للتكاملات الحالية التحقق من كيفية استخدام تلك التعريفات قبل الترقية. ويذكر مستودع Google أيضاً أن دعم ميزات Java لا يزال قيد التطوير ولا يوازي حزم SDK الخاصة بـ Python وJavaScript/TypeScript وGo.

التغيير الأبرز

يوفر عميل 1.0 لتطبيق Java طريقة محددة لاكتشاف الأدوات التي يعرضها MCP Toolbox واستدعائها. وتقع الميزة الجديدة HttpMcpTransport خلف واجهة للنقل، بينما تفصل CredentialsProvider و AuthMethods حل بيانات الاعتماد عن العميل. وتقول Google إن بيانات الاعتماد تُحل بصورة غير متزامنة لكل طلب. يضيف الإصدار أيضاً قيماً افتراضية للمعلمات، وتحذيرات HTTP بشأن كشف بيانات الاعتماد، واختيار الإصدار، وتتبع الجلسات، وخريطة لرؤوس الطلب المخصصة. هذه ميزات موثقة في SDK وليست اختبارات أداء أو أمان أجرتها BIG CHANGE.

Toolbox نفسه خادم منفصل. يهيئه المشغّل بمصادر البيانات والأدوات؛ ويتصل عميل Java بعنوان URL الخاص به، ويحمل تعريفات الأدوات ويرسل الاستدعاءات. لا يؤدي اعتماد Java وحده إلى إعداد قاعدة بيانات أو منح أذونات أو نشر ذلك الخادم. وتشرح وثائق Java الرسمية أدوار العميل والخادم، بينما يشترط مستودع SDK تشغيل الخادم قبل إعداد العميل.

ما الذي يمكن لفريق Java تقييمه

تستند الخطوات التالية إلى وثائق Google ومستودعها. لم تشغّل BIG CHANGE الشفرة ولم تتصل بقاعدة بيانات.

  1. أعدّ خادم Toolbox ومصدر بيانات منفصلين. تغطي وثائق البدء من Google الخادم وتعريفات الأدوات والتكاملات المدعومة. للتقييم الأول، اختر أداة قاعدة بيانات محدودة للقراءة فقط وراجع ضوابط الوصول إلى الخادم. يحدد مستودع SDK الإصدار Java 17 أو أحدث كبيئة تشغيل أساسية.
  2. ثبّت إصدار اعتماد Java. يعرض كل من إعلان إصدار 1.0 و المستودع إحداثيات Maven com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0؛ ويورد المستودع أيضاً صيغة Gradle. لا تزال وثائق Java العامة تستخدم عنصراً نائباً هو VERSION ، لذا فإن حزمة الإصدار هي المرجع الدقيق لهذا التقييم.
  3. اتصل بالخادم وافحص أداة. وجّه McpToolboxClient إلى عنوان URL للخادم الجاري تشغيله /mcp ، ثم استخدم loadToolsetأو listTools أو loadTool لفحص تعريفاته المنشورة قبل استدعاء الأداة. يعرض المستودع استدعاءً باستخدام Java Map ونتيجة نصية عائدة. يكون الفحص ناجحاً عند تلقي استجابة من أداة محددة ومهيأة، لا بمجرد إنشاء كائن عميل بلا خطأ.
  4. اختر المصادقة بعناية. يصف إعلان 1.0 CredentialsProvider و AuthMethods لبيانات اعتماد العميل، بما في ذلك مسار Google Application Default Credentials لـ OIDC. كما يشرح تحذيرات HTTP عند احتمال انتقال بيانات الاعتماد بنص واضح. لا يحل التحذير محل نقطة نهاية HTTPS أو التفويض من جانب الخادم. ينبغي مراجعة القيم المرتبطة بالمعلمات الحساسة عند حدود الخادم والعميل، خصوصاً عند الترقية من إصدار تجريبي.

النتيجة المطلوبة هي تعريف أداة واستجابة يطابقان أذونات قاعدة البيانات المقصودة للوكيل. إذا فشل الاكتشاف، فتحقق أولاً من عنوان URL للخادم واسم الأداة المتاحة وإعداد المصادقة. وإذا فشل الاستدعاء، فقارن المعلمات المطلوبة بالقيم المرسلة وافحص سجلات الخادم. هذه فحوص تشخيصية تستند إلى الفصل الموثق بين المكونات، وليست ادعاءً بأن عملية نشر بعينها ستتعافى تلقائياً.

القيود والتكلفة

يعرض تطبيق النقل النموذجي من Google كلاً من Spring Boot وLangChain4j وهما يستدعيان أدوات Toolbox المدعومة بـ AlloyDB. ويصف مقال أكتوبر Cymbal Transit بأنه خيالي. إنه يوضح تصميم تكامل، لا استخداماً مقاساً من العملاء أو نتيجة موثوقية.

يحمل مستودع Java SDK ترخيص Apache 2.0. ولا يحدد ذلك أسعار قاعدة البيانات أو النشر السحابي أو استدعاءات النماذج أو حركة الشبكة؛ على الفرق تسعير الخدمات التي تختارها فعلياً. ويصنف المستودع استخدام GraalVM native-image كتجريبي ويحذر من أن دعم ميزات Java SDK غير مكتمل مقارنة بعملاء Toolbox الآخرين. راجع هذه الحدود في ضوء إطار العمل ومصدر البيانات المحددين قبل اعتبار ادعاء Google بملاءمته للمؤسسات مثبتاً لنظام إنتاجي.

المصادر ومزيد من القراءة

  • إعلان Google Cloud، 6 أكتوبر 2026: رواية Google لميزات v1.0 ومثال النقل الخيالي. والحديث عن الملاءمة للإنتاج ادعاء من المورّد.
  • إصدار Java SDK v1.0.0، 9 سبتمبر 2026: تاريخ الإصدار والميزات والتغيير غير المتوافق المذكور.
  • مستودع Java SDK: إحداثيات الاعتماد ومتطلبات Java واستدعاءات العميل والترخيص والتحذير الحالي بشأن تكافؤ الميزات. تمت مراجعته في 12 أكتوبر 2026.
  • وثائق Java SDK الرسمية: متطلب الخادم ومرجع التثبيت. عُدلت الصفحة آخر مرة في 25 سبتمبر 2026؛ والعنصر النائب للإصدار فيها أقل دقة من سجل إصدار 1.0.