README.md

عملی نفاذ

(اوپر دی گئی تصویر پر کلک کریں تاکہ اس سبق کی ویڈیو دیکھ سکیں)

عملی نفاذ وہ جگہ ہے جہاں ماڈل کانٹیکسٹ پروٹوکول (MCP) کی طاقت واضح ہوتی ہے۔ اگرچہ MCP کے نظریہ اور فن تعمیر کو سمجھنا اہم ہے، اصل قدر تب ظاہر ہوتی ہے جب آپ ان تصورات کو حقیقی دنیا کے مسائل حل کرنے کے لیے استعمال کرتے ہیں۔ یہ باب تصوراتی علم اور عملی ترقی کے درمیان خلا کو پُر کرتا ہے، اور آپ کو MCP پر مبنی ایپلیکیشنز کو حقیقت میں لانے کے عمل میں رہنمائی فراہم کرتا ہے۔

چاہے آپ ذہین معاونین تیار کر رہے ہوں، کاروباری ورک فلو میں AI کو شامل کر رہے ہوں، یا ڈیٹا پروسیسنگ کے لیے حسب ضرورت ٹولز بنا رہے ہوں، MCP ایک لچکدار بنیاد فراہم کرتا ہے۔ اس کا زبان سے آزاد ڈیزائن اور مشہور پروگرامنگ زبانوں کے لیے آفیشل SDKs اسے مختلف قسم کے ڈویلپرز کے لیے قابل رسائی بناتے ہیں۔ ان SDKs کا استعمال کرتے ہوئے، آپ تیزی سے پروٹوٹائپ بنا سکتے ہیں، تکرار کر سکتے ہیں، اور اپنے حل کو مختلف پلیٹ فارمز اور ماحول میں اسکیل کر سکتے ہیں۔

اگلے حصوں میں، آپ کو عملی مثالیں، نمونہ کوڈ، اور ڈیپلائمنٹ کی حکمت عملی ملے گی جو C#, Java with Spring, TypeScript, JavaScript, اور Python میں MCP کو نافذ کرنے کا مظاہرہ کرتی ہیں۔ آپ یہ بھی سیکھیں گے کہ MCP سرورز کو ڈیبگ اور ٹیسٹ کیسے کریں، APIs کو منظم کریں، اور Azure کا استعمال کرتے ہوئے حل کو کلاؤڈ میں ڈیپلائے کریں۔ یہ عملی وسائل آپ کی سیکھنے کی رفتار کو بڑھانے اور آپ کو مضبوط، پروڈکشن کے لیے تیار MCP ایپلیکیشنز بنانے میں اعتماد فراہم کرنے کے لیے ڈیزائن کیے گئے ہیں۔

جائزہ

یہ سبق متعدد پروگرامنگ زبانوں میں MCP کے نفاذ کے عملی پہلوؤں پر مرکوز ہے۔ ہم یہ دریافت کریں گے کہ MCP SDKs کو C#, Java with Spring, TypeScript, JavaScript, اور Python میں استعمال کرتے ہوئے مضبوط ایپلیکیشنز کیسے بنائی جائیں، MCP سرورز کو ڈیبگ اور ٹیسٹ کیسے کیا جائے، اور دوبارہ استعمال کے قابل وسائل، پرامپٹس، اور ٹولز کیسے تخلیق کیے جائیں۔

سیکھنے کے مقاصد

اس سبق کے اختتام تک، آپ یہ کرنے کے قابل ہوں گے:

• مختلف پروگرامنگ زبانوں میں آفیشل SDKs کا استعمال کرتے ہوئے MCP حل نافذ کریں
• MCP سرورز کو منظم طریقے سے ڈیبگ اور ٹیسٹ کریں
• سرور کی خصوصیات (Resources, Prompts, اور Tools) تخلیق کریں اور استعمال کریں
• پیچیدہ کاموں کے لیے مؤثر MCP ورک فلو ڈیزائن کریں
• کارکردگی اور قابل اعتمادیت کے لیے MCP نفاذ کو بہتر بنائیں

آفیشل SDK وسائل

ماڈل کانٹیکسٹ پروٹوکول متعدد زبانوں کے لیے آفیشل SDKs پیش کرتا ہے:

• C# SDK
• Java with Spring SDK نوٹ: Project Reactor پر انحصار کرتا ہے۔ (بحث کا مسئلہ 246 دیکھیں۔)
• TypeScript SDK
• Python SDK
• Kotlin SDK

MCP SDKs کے ساتھ کام کرنا

یہ حصہ متعدد پروگرامنگ زبانوں میں MCP کے نفاذ کی عملی مثالیں فراہم کرتا ہے۔ آپ samples ڈائریکٹری میں زبان کے لحاظ سے منظم نمونہ کوڈ تلاش کر سکتے ہیں۔

دستیاب نمونے

ریپوزٹری میں درج ذیل زبانوں میں نمونہ نفاذ شامل ہیں:

• C#
• Java with Spring
• TypeScript
• JavaScript
• Python

ہر نمونہ اس مخصوص زبان اور ایکو سسٹم کے لیے کلیدی MCP تصورات اور نفاذ کے نمونوں کا مظاہرہ کرتا ہے۔

بنیادی سرور خصوصیات

MCP سرورز درج ذیل خصوصیات کے کسی بھی امتزاج کو نافذ کر سکتے ہیں:

وسائل

وسائل صارف یا AI ماڈل کے استعمال کے لیے سیاق و سباق اور ڈیٹا فراہم کرتے ہیں:

• دستاویزات کے ذخیرے
• علم کے ذخیرے
• منظم ڈیٹا کے ذرائع
• فائل سسٹمز

پرامپٹس

پرامپٹس صارفین کے لیے ٹیمپلیٹ شدہ پیغامات اور ورک فلو ہیں:

• پہلے سے طے شدہ گفتگو کے ٹیمپلیٹس
• رہنمائی شدہ تعامل کے نمونے
• خصوصی مکالماتی ڈھانچے

ٹولز

ٹولز وہ افعال ہیں جو AI ماڈل انجام دیتا ہے:

• ڈیٹا پروسیسنگ کی سہولیات
• بیرونی API انضمام
• حسابی صلاحیتیں
• تلاش کی فعالیت

نمونہ نفاذ: C# نفاذ

آفیشل C# SDK ریپوزٹری میں متعدد نمونہ نفاذ شامل ہیں جو MCP کے مختلف پہلوؤں کو ظاہر کرتے ہیں:

• بنیادی MCP کلائنٹ: ایک سادہ مثال جو دکھاتی ہے کہ MCP کلائنٹ کیسے بنایا جائے اور ٹولز کو کیسے کال کیا جائے
• بنیادی MCP سرور: بنیادی ٹول رجسٹریشن کے ساتھ کم سے کم سرور نفاذ
• ایڈوانسڈ MCP سرور: مکمل خصوصیات والا سرور جس میں ٹول رجسٹریشن، تصدیق، اور خرابیوں کا انتظام شامل ہے
• ASP.NET انضمام: ASP.NET Core کے ساتھ انضمام کا مظاہرہ کرنے والے مثالیں
• ٹول نفاذ کے نمونے: مختلف پیچیدگی کی سطحوں کے ساتھ ٹولز کو نافذ کرنے کے نمونے

C# MCP SDK پیش نظارہ میں ہے اور APIs تبدیل ہو سکتے ہیں۔ ہم SDK کے ارتقاء کے ساتھ اس بلاگ کو مسلسل اپ ڈیٹ کریں گے۔

کلیدی خصوصیات

• C# MCP Nuget ModelContextProtocol
• اپنا پہلا MCP سرور بنانا۔

مکمل C# نفاذ کے نمونوں کے لیے، آفیشل C# SDK نمونہ ریپوزٹری ملاحظہ کریں۔

نمونہ نفاذ: Java with Spring نفاذ

Java with Spring SDK مضبوط MCP نفاذ کے اختیارات پیش کرتا ہے جن میں انٹرپرائز گریڈ خصوصیات شامل ہیں۔

کلیدی خصوصیات

• Spring Framework انضمام
• مضبوط قسم کی حفاظت
• ری ایکٹو پروگرامنگ کی حمایت
• جامع خرابیوں کا انتظام

مکمل Java with Spring نفاذ کے نمونے کے لیے، samples/java/containerapp/README.md میں نمونہ ڈائریکٹری دیکھیں۔

نمونہ نفاذ: JavaScript نفاذ

JavaScript SDK MCP نفاذ کے لیے ایک ہلکا پھلکا اور لچکدار طریقہ فراہم کرتا ہے۔

کلیدی خصوصیات

• Node.js اور براؤزر کی حمایت
• وعدہ پر مبنی API
• Express اور دیگر فریم ورک کے ساتھ آسان انضمام
• اسٹریمنگ کے لیے WebSocket کی حمایت

مکمل JavaScript نفاذ کے نمونے کے لیے، samples/javascript/README.md میں نمونہ ڈائریکٹری دیکھیں۔

نمونہ نفاذ: Python نفاذ

Python SDK MCP نفاذ کے لیے ایک Pythonic طریقہ پیش کرتا ہے جس میں بہترین ML فریم ورک انضمام شامل ہیں۔

کلیدی خصوصیات

• asyncio کے ساتھ async/await کی حمایت
• FastAPI انضمام
• سادہ ٹول رجسٹریشن
• مشہور ML لائبریریوں کے ساتھ مقامی انضمام

مکمل Python نفاذ کے نمونے کے لیے، samples/python/README.md میں نمونہ ڈائریکٹری دیکھیں۔

API انتظام

Azure API Management MCP سرورز کو محفوظ کرنے کا ایک بہترین جواب ہے۔ خیال یہ ہے کہ آپ کے MCP سرور کے سامنے ایک Azure API Management انسٹینس رکھیں اور اسے وہ خصوصیات سنبھالنے دیں جو آپ ممکنہ طور پر چاہتے ہیں جیسے:

• ریٹ لمیٹنگ
• ٹوکن انتظام
• مانیٹرنگ
• لوڈ بیلنسنگ
• سیکیورٹی

Azure نمونہ

یہاں ایک Azure نمونہ ہے جو بالکل یہی کرتا ہے، یعنی MCP سرور بنانا اور اسے Azure API Management کے ساتھ محفوظ کرنا۔

ذیل کی تصویر میں دیکھیں کہ اجازت کا بہاؤ کیسے ہوتا ہے:

پیش کردہ تصویر میں، درج ذیل ہوتا ہے:

• Microsoft Entra کا استعمال کرتے ہوئے تصدیق/اجازت ہوتی ہے۔
• Azure API Management گیٹ وے کے طور پر کام کرتا ہے اور پالیسیوں کا استعمال کرتے ہوئے ٹریفک کو ہدایت دیتا ہے اور منظم کرتا ہے۔
• Azure Monitor تمام درخواستوں کو مزید تجزیے کے لیے لاگ کرتا ہے۔

اجازت کا بہاؤ

آئیے اجازت کے بہاؤ کو مزید تفصیل سے دیکھتے ہیں:

MCP اجازت کی وضاحت

MCP اجازت کی وضاحت کے بارے میں مزید جانیں۔

Azure پر ریموٹ MCP سرور کو ڈیپلائے کریں

آئیے دیکھتے ہیں کہ ہم پہلے ذکر کردہ نمونہ کو کیسے ڈیپلائے کر سکتے ہیں:

1. ریپوزٹری کلون کریں

   git clone https://github.com/Azure-Samples/remote-mcp-apim-functions-python.git
   cd remote-mcp-apim-functions-python

2. Microsoft.App ریسورس پرووائیڈر رجسٹر کریں۔

   • اگر آپ Azure CLI استعمال کر رہے ہیں، تو az provider register --namespace Microsoft.App --wait چلائیں۔
   • اگر آپ Azure PowerShell استعمال کر رہے ہیں، تو Register-AzResourceProvider -ProviderNamespace Microsoft.App چلائیں۔ پھر کچھ وقت کے بعد (Get-AzResourceProvider -ProviderNamespace Microsoft.App).RegistrationState چلائیں تاکہ رجسٹریشن مکمل ہونے کی تصدیق کریں۔

3. یہ azd کمانڈ چلائیں تاکہ API Management سروس، فنکشن ایپ (کوڈ کے ساتھ) اور دیگر مطلوبہ Azure وسائل کو پروویژن کریں

   azd up

   یہ کمانڈز Azure پر تمام کلاؤڈ وسائل کو ڈیپلائے کرنی چاہیے۔

MCP انسپکٹر کے ساتھ اپنے سرور کی جانچ

1. ایک نئی ٹرمینل ونڈو میں MCP انسپکٹر انسٹال کریں اور چلائیں

   npx @modelcontextprotocol/inspector

   آپ کو ایک انٹرفیس نظر آنا چاہیے جو اس طرح دکھائی دیتا ہے:

   

2. URL کو انسپکٹر ویب ایپ سے لوڈ کرنے کے لیے CTRL کلک کریں (مثال کے طور پر http://127.0.0.1:6274/#resources)

3. ٹرانسپورٹ قسم کو SSE پر سیٹ کریں

4. اپنے چلتے ہوئے API Management SSE اینڈ پوائنٹ کے URL کو سیٹ کریں جو azd up کے بعد ظاہر ہوتا ہے اور Connect کریں:

   https://<apim-servicename-from-azd-output>.azure-api.net/mcp/sse

5. ٹولز کی فہرست بنائیں۔ کسی ٹول پر کلک کریں اور Run Tool کریں۔

اگر تمام مراحل کامیاب رہے، تو آپ کو MCP سرور سے جڑنا چاہیے اور آپ نے ایک ٹول کو کال کرنے کے قابل ہونا چاہیے۔

Azure کے لیے MCP سرورز

Remote-mcp-functions: یہ ریپوزٹریز Azure Functions کا استعمال کرتے ہوئے Python, C# .NET یا Node/TypeScript کے ساتھ حسب ضرورت ریموٹ MCP (Model Context Protocol) سرورز بنانے اور ڈیپلائے کرنے کے لیے کوئیک اسٹارٹ ٹیمپلیٹ ہیں۔

نمونے ایک مکمل حل فراہم کرتے ہیں جو ڈویلپرز کو یہ کرنے کی اجازت دیتا ہے:

• مقامی طور پر بنائیں اور چلائیں: مقامی مشین پر MCP سرور تیار کریں اور ڈیبگ کریں
• Azure پر ڈیپلائے کریں: ایک سادہ azd up کمانڈ کے ساتھ کلاؤڈ پر آسانی سے ڈیپلائے کریں
• کلائنٹس سے جڑیں: مختلف کلائنٹس سے MCP سرور سے جڑیں، بشمول VS Code کے Copilot ایجنٹ موڈ اور MCP انسپکٹر ٹول

کلیدی خصوصیات

• ڈیزائن کے لحاظ سے سیکیورٹی: MCP سرور کو کیز اور HTTPS کا استعمال کرتے ہوئے محفوظ کیا گیا ہے
• تصدیق کے اختیارات: بلٹ ان تصدیق اور/یا API Management کا استعمال کرتے ہوئے OAuth کی حمایت کرتا ہے
• نیٹ ورک کی تنہائی: Azure Virtual Networks (VNET) کا استعمال کرتے ہوئے نیٹ ورک کی تنہائی کی اجازت دیتا ہے
• سرور لیس فن تعمیر: Azure Functions کا فائدہ اٹھاتے ہوئے اسکیل ایبل، ایونٹ ڈرائیون ایگزیکیوشن
• مقامی ترقی: جامع مقامی ترقی اور ڈیبگنگ کی حمایت
• سادہ ڈیپلائمنٹ: Azure پر ڈیپلائمنٹ کا آسان عمل

ریپوزٹری میں تمام ضروری کنفیگریشن فائلز، سورس کوڈ، اور انفراسٹرکچر کی تعریفیں شامل ہیں تاکہ پروڈکشن کے لیے تیار MCP سرور نفاذ کے ساتھ جلدی شروع کیا جا سکے۔

• Azure Remote MCP Functions Python - Azure Functions کے ساتھ Python کا استعمال کرتے ہوئے MCP کا نمونہ نفاذ

• Azure Remote MCP Functions .NET - Azure Functions کے ساتھ C# .NET کا استعمال کرتے ہوئے MCP کا نمونہ نفاذ

• Azure Remote MCP Functions Node/Typescript - Azure Functions کے ساتھ Node/TypeScript کا استعمال کرتے ہوئے MCP کا نمونہ نفاذ۔

کلیدی نکات

• MCP SDKs زبان کے لحاظ سے مخصوص ٹولز فراہم کرتے ہیں تاکہ مضبوط MCP حل نافذ کیے جا سکیں
• ڈیبگنگ اور ٹیسٹنگ کا عمل قابل اعتماد MCP ایپلیکیشنز کے لیے اہم ہے
• دوبارہ استعمال کے قابل پرامپٹ ٹیمپلیٹس مستقل AI تعاملات کو فعال کرتے ہیں
• اچھی طرح سے ڈیزائن کردہ ورک فلو متعدد ٹولز کا استعمال کرتے ہوئے پیچیدہ کاموں کو ترتیب دے سکتے ہیں
• MCP حل نافذ کرنے کے لیے سیکیورٹی، کارکردگی، اور خرابیوں کے انتظام پر غور کرنا ضروری ہے

مشق

ایک عملی MCP ورک فلو ڈیزائن کریں جو آپ کے شعبے میں ایک حقیقی دنیا کے مسئلے کو حل کرے:

1. 3-4 ٹولز کی شناخت کریں جو اس مسئلے کو حل کرنے کے لیے مفید ہوں گے
2. ایک ورک فلو ڈایاگرام بنائیں جو دکھائے کہ یہ ٹولز کیسے تعامل کرتے ہیں
3. اپنی پسندیدہ زبان کا استعمال کرتے ہوئے ان ٹولز میں سے ایک کا بنیادی ورژن نافذ کریں
4. ایک پرامپٹ ٹیمپلیٹ بنائیں جو ماڈل کو آپ کے ٹول کو مؤثر طریقے سے استعمال کرنے میں مدد دے

اضافی وسائل

---

اگلا: ایڈوانسڈ موضوعات

ڈسکلیمر:
یہ دستاویز AI ترجمہ سروس Co-op Translator کا استعمال کرتے ہوئے ترجمہ کی گئی ہے۔ ہم درستگی کے لیے کوشش کرتے ہیں، لیکن براہ کرم آگاہ رہیں کہ خودکار ترجمے میں غلطیاں یا عدم درستگی ہو سکتی ہیں۔ اصل دستاویز، جو اس کی اصل زبان میں ہے، کو مستند ذریعہ سمجھا جانا چاہیے۔ اہم معلومات کے لیے، پیشہ ور انسانی ترجمہ کی سفارش کی جاتی ہے۔ اس ترجمے کے استعمال سے پیدا ہونے والی کسی بھی غلط فہمی یا غلط تشریح کے لیے ہم ذمہ دار نہیں ہیں۔