MCP Toolbox for Databases کے لیے Google کا Java کلائنٹ 9 ستمبر کو ورژن 1.0.0 تک پہنچا۔ 6 اکتوبر کے ایک اعلان میںکمپنی نے الگ سے چلنے والے Toolbox سرور سے Java ایپلی کیشنز جوڑنے والی ٹیموں کے لیے ٹرانسپورٹ، تصدیق اور ٹول پیرامیٹرز میں تبدیلیاں بیان کیں۔ کوڈ کے ریلیز ریکارڈ کے مطابق کوڈ اس اعلان سے تقریباً ایک ماہ پہلے جاری ہوا تھا۔

اب کلائنٹ اپنانے کا فیصلہ کرنے والی Java ٹیم کے لیے یہ فرق اہم ہے۔ Google ورژن 1.0 کو مستحکم اور پچھلے ورژنز سے مطابقت رکھنے والی بنیاد کہتا ہے، لیکن اسی ریلیز ریکارڈ میں ایک غیر موافق تبدیلی بھی درج ہے: ایجنٹ کے سامنے ظاہر کی جانے والی ٹول تعریف سے منسلک پیرامیٹرز ہٹا دیے جاتے ہیں۔ موجودہ انٹیگریشنز کو اپ گریڈ سے پہلے دیکھنا چاہیے کہ وہ ان تعریفوں کو کیسے استعمال کرتی ہیں۔ Google کی ریپوزٹری یہ بھی کہتی ہے کہ Java فیچر سپورٹ اب بھی جاری ترقی میں ہے اور Python، JavaScript/TypeScript اور Go SDKs کے برابر نہیں۔

اہم تبدیلی

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 coordinates دکھائے گئے ہیں 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 بیان کرتا ہے، جن میں OIDC کے لیے Google Application Default Credentials کا راستہ بھی شامل ہے۔ یہ ان صورتوں کے HTTP انتباہات بھی بیان کرتا ہے جب اسناد سادہ متن میں منتقل ہوں۔ انتباہ HTTPS اینڈپوائنٹ یا سرور سائیڈ اجازت کا متبادل نہیں۔ حساس پیرامیٹرز کی منسلک قدروں کا سرور اور کلائنٹ کی حدود پر جائزہ لیا جانا چاہیے، خصوصاً پری ریلیز بلڈ سے اپ گریڈ کرتے وقت۔

مطلوبہ نتیجہ ایسا ٹول تعارف اور جواب ہے جو ایجنٹ کے لیے طے شدہ ڈیٹابیس اجازتوں سے مطابقت رکھتا ہو۔ دریافت ناکام ہو تو پہلے سرور URL، دستیاب ٹول کا نام اور تصدیق کی ترتیب دیکھیں۔ کال ناکام ہو تو ٹول کے مطلوبہ پیرامیٹرز کو بھیجی گئی قدروں سے ملائیں اور سرور لاگز دیکھیں۔ یہ اجزا کی دستاویزی علیحدگی پر مبنی تشخیصی جانچیں ہیں، کسی مخصوص تعیناتی کے خودبخود بحال ہونے کا دعویٰ نہیں۔

حدود اور لاگت

Google کی نمونہ ٹرانزٹ ایپلی کیشن AlloyDB سے چلنے والے Toolbox ٹولز کو Spring Boot اور LangChain4j کے ذریعے کال ہوتے دکھاتی ہے۔ اکتوبر کا مضمون Cymbal Transit کو فرضی قرار دیتا ہے۔ یہ انٹیگریشن ڈیزائن کی مثال ہے، ناپا ہوا صارف استعمال یا قابل اعتماد ہونے کا نتیجہ نہیں۔

Java SDK ریپوزٹری پر Apache 2.0 لائسنسلاگو ہے۔ اس سے ڈیٹابیس، کلاؤڈ تعیناتی، ماڈل کالز یا نیٹ ورک ٹریفک کی قیمت طے نہیں ہوتی؛ ٹیموں کو اپنی منتخب کردہ خدمات کی لاگت نکالنی ہوگی۔ ریپوزٹری GraalVM native-image کے استعمال کو تجرباتی قرار دیتی ہے اور خبردار کرتی ہے کہ دیگر Toolbox کلائنٹس کے مقابلے میں Java SDK فیچر سپورٹ نامکمل ہے۔ Google کے ادارہ جاتی موزونیت کے دعوے کو پیداواری نظام کے لیے تصدیق شدہ سمجھنے سے پہلے مخصوص فریم ورک اور ڈیٹا ذریعہ کے لحاظ سے ان حدود کو دیکھیں۔

ذرائع اور مزید مطالعہ

  • Google Cloud اعلان، 6 اکتوبر 2026: v1.0 فیچرز اور فرضی ٹرانزٹ مثال کے بارے میں Google کی وضاحت۔ پیداواری موزونیت کی زبان فراہم کنندہ کا دعویٰ ہے۔
  • Java SDK v1.0.0 ریلیز، 9 ستمبر 2026: ریلیز کی تاریخ، فیچرز اور درج شدہ غیر موافق تبدیلی۔
  • Java SDK ریپوزٹری: انحصار coordinates، Java تقاضا، کلائنٹ کالز، لائسنس اور فیچر برابری سے متعلق موجودہ تنبیہ۔ 12 اکتوبر 2026 کو دیکھا گیا۔
  • سرکاری Java SDK دستاویزات: سرور کی پیشگی شرط اور تنصیب کا حوالہ۔ صفحہ آخری بار 25 ستمبر 2026 کو تبدیل ہوا؛ اس کا ورژن پلیس ہولڈر 1.0 ریلیز ریکارڈ سے کم درست ہے۔