AI-translated from English; not yet reviewed by a fluent editor.

# Google تشرح MCP Toolbox Java SDK 1.0 لوكلاء قواعد البيانات

> فصّلت Google في أكتوبر إصدار MCP Toolbox Java SDK 1.0، بعد نشر الشفرة في سبتمبر. يضيف العميل واجهات للنقل والمصادقة، بينما يسجل سجل الإصدار تغييراً غير متوافق وينبه المستودع إلى أن تكافؤ الميزات غير مكتمل.

By BIG CHANGE Editorial

Published: 2026-10-12T18:00:12.162Z
Updated: 2026-10-12T18:00:12.162Z
Canonical: https://bigchange.ai/blog/google-mcp-toolbox-java-sdk-v1-stable-interfaces

![Conceptual charcoal illustration of an orange network cable plugged into a generic server-rack patch panel.](https://bigchange.ai/api/media/file/mcp-toolbox-java-patch-bay-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. No MCP Toolbox product interface, database transaction or tested integration is depicted.

وصل عميل Google بلغة Java لـ MCP Toolbox for Databases إلى الإصدار 1.0.0 في 9 سبتمبر. وفي [إعلان](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)صدر في 6 أكتوبر، فصّلت الشركة تغييرات النقل والمصادقة ومعلمات الأدوات للفرق التي تربط تطبيقات Java بخادم Toolbox يعمل على نحو منفصل. ويؤرخ سجل [الإصدار](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) نشر الشفرة قبل ذلك الإعلان بنحو شهر.

هذا الفرق مهم لفريق Java يقرر ما إذا كان سيعتمد العميل الآن. تصف Google الإصدار 1.0 بأنه أساس مستقر ومتوافق مع الإصدارات السابقة، لكن سجل الإصدار نفسه يذكر تغييراً غير متوافق: تُحذف المعلمات المرتبطة من تعريف الأداة المعروض على الوكيل. ينبغي للتكاملات الحالية التحقق من كيفية استخدام تلك التعريفات قبل الترقية. ويذكر [مستودع Google](https://github.com/googleapis/mcp-toolbox-sdk-java) أيضاً أن دعم ميزات Java لا يزال قيد التطوير ولا يوازي حزم SDK الخاصة بـ Python وJavaScript/TypeScript وGo.

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

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

Toolbox نفسه خادم منفصل. يهيئه المشغّل بمصادر البيانات والأدوات؛ ويتصل عميل Java بعنوان URL الخاص به، ويحمل تعريفات الأدوات ويرسل الاستدعاءات. لا يؤدي اعتماد Java وحده إلى إعداد قاعدة بيانات أو منح أذونات أو نشر ذلك الخادم. وتشرح [وثائق Java الرسمية](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) أدوار العميل والخادم، بينما يشترط [مستودع SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) تشغيل الخادم قبل إعداد العميل.

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

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

1. **أعدّ خادم Toolbox ومصدر بيانات منفصلين.** تغطي [وثائق البدء من Google](https://mcp-toolbox.dev/documentation/introduction/) الخادم وتعريفات الأدوات والتكاملات المدعومة. للتقييم الأول، اختر أداة قاعدة بيانات محدودة للقراءة فقط وراجع ضوابط الوصول إلى الخادم. يحدد مستودع SDK الإصدار Java 17 أو أحدث كبيئة تشغيل أساسية.
2. **ثبّت إصدار اعتماد Java.** يعرض كل من [إعلان إصدار 1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) و [المستودع](https://github.com/googleapis/mcp-toolbox-sdk-java) إحداثيات 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 للخادم واسم الأداة المتاحة وإعداد المصادقة. وإذا فشل الاستدعاء، فقارن المعلمات المطلوبة بالقيم المرسلة وافحص سجلات الخادم. هذه فحوص تشخيصية تستند إلى الفصل الموثق بين المكونات، وليست ادعاءً بأن عملية نشر بعينها ستتعافى تلقائياً.

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

يعرض [تطبيق النقل النموذجي](https://github.com/googleapis/mcp-toolbox-sdk-java/tree/main/demo-applications/cymbal-transit) من Google كلاً من Spring Boot وLangChain4j وهما يستدعيان أدوات Toolbox المدعومة بـ AlloyDB. ويصف مقال أكتوبر Cymbal Transit بأنه خيالي. إنه يوضح تصميم تكامل، لا استخداماً مقاساً من العملاء أو نتيجة موثوقية.

يحمل مستودع Java SDK [ترخيص Apache 2.0](https://github.com/googleapis/mcp-toolbox-sdk-java/blob/main/LICENSE). ولا يحدد ذلك أسعار قاعدة البيانات أو النشر السحابي أو استدعاءات النماذج أو حركة الشبكة؛ على الفرق تسعير الخدمات التي تختارها فعلياً. ويصنف المستودع استخدام GraalVM native-image كتجريبي ويحذر من أن دعم ميزات Java SDK غير مكتمل مقارنة بعملاء Toolbox الآخرين. راجع هذه الحدود في ضوء إطار العمل ومصدر البيانات المحددين قبل اعتبار ادعاء Google بملاءمته للمؤسسات مثبتاً لنظام إنتاجي.

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

- [إعلان Google Cloud، 6 أكتوبر 2026](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/): رواية Google لميزات v1.0 ومثال النقل الخيالي. والحديث عن الملاءمة للإنتاج ادعاء من المورّد.
- [إصدار Java SDK v1.0.0، 9 سبتمبر 2026](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0): تاريخ الإصدار والميزات والتغيير غير المتوافق المذكور.
- [مستودع Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java): إحداثيات الاعتماد ومتطلبات Java واستدعاءات العميل والترخيص والتحذير الحالي بشأن تكافؤ الميزات. تمت مراجعته في 12 أكتوبر 2026.
- [وثائق Java SDK الرسمية](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/): متطلب الخادم ومرجع التثبيت. عُدلت الصفحة آخر مرة في 25 سبتمبر 2026؛ والعنصر النائب للإصدار فيها أقل دقة من سجل إصدار 1.0.

## Sources

- [Google Cloud Blog: إعلان MCP Toolbox Java SDK v1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) — إعلان لاحق وشرح لإصدار 9 سبتمبر. ملاءمة الإنتاج ادعاء من Google ولم يُتحقق منه مستقلاً.
- [إصدار MCP Toolbox Java SDK v1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) — التاريخ المعتمد لنشر الشفرة ومعلومات الميزات، بما فيها التغيير غير المتوافق المذكور.
- [Google APIs: مستودع مصدر MCP Toolbox Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) — مصدر التنفيذ الرسمي؛ طابق علامات الإصدارات الحالية وواجهات API مع v1.0.0 قبل استخدام أمثلة الشفرة.
- [وثائق MCP Toolbox Java SDK الرسمية](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) — لا يزال مرجع الإعداد العام الرسمي يتضمن العنصر النائب VERSION؛ إصدار 1.0 المحدد والمستودع أدق.