Skip to content

Latest commit

 

History

History
263 lines (193 loc) · 24 KB

File metadata and controls

263 lines (193 loc) · 24 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

ان وسائل کو استعمال شروع کرنے کے لیے یہ مراحل فالو کریں:

  1. ریپوزیٹری کو فورک کریں: کلک کریں GitHub forks
  2. ریپوزیٹری کلون کریں: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Azure AI Foundry Discord میں شامل ہوں اور ماہرین و دیگر ڈویلپرز سے ملیں

🌐 کثیراللسانی سپورٹ

GitHub Action کے ذریعے سپورٹ (خودکار اور ہمیشہ تازہ ترین)

French | Spanish | German | Russian | Arabic | Persian (Farsi) | Urdu | Chinese (Simplified) | Chinese (Traditional, Macau) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Taiwan) | Japanese | Korean | Hindi | Bengali | Marathi | Nepali | Punjabi (Gurmukhi) | Portuguese (Portugal) | Portuguese (Brazil) | Italian | Polish | Turkish | Greek | Thai | Swedish | Danish | Norwegian | Finnish | Dutch | Hebrew | Vietnamese | Indonesian | Malay | Tagalog (Filipino) | Swahili | Hungarian | Czech | Slovak | Romanian | Bulgarian | Serbian (Cyrillic) | Croatian | Slovenian | Ukrainian | Burmese (Myanmar)

🚀 ماڈل کانٹیکسٹ پروٹوکول (MCP) نصاب برائے مبتدی

C#, Java, JavaScript, Python، اور TypeScript میں عملی کوڈ مثالوں کے ساتھ MCP سیکھیں

🧠 ماڈل کانٹیکسٹ پروٹوکول نصاب کا جائزہ

Model Context Protocol (MCP) ایک جدید فریم ورک ہے جو AI ماڈلز اور کلائنٹ ایپلیکیشنز کے درمیان تعاملات کو معیاری بنانے کے لیے ڈیزائن کیا گیا ہے۔ یہ اوپن سورس نصاب ایک منظم تعلیمی راستہ فراہم کرتا ہے، جس میں عملی کوڈنگ مثالیں اور حقیقی دنیا کے استعمال کے کیسز شامل ہیں، جو مقبول پروگرامنگ زبانوں جیسے C#, Java, JavaScript, TypeScript، اور Python میں دستیاب ہیں۔

چاہے آپ AI ڈویلپر ہوں، سسٹم آرکیٹیکٹ، یا سافٹ ویئر انجینئر، یہ گائیڈ MCP کی بنیادی باتوں اور نفاذ کی حکمت عملیوں میں مہارت حاصل کرنے کے لیے آپ کا مکمل ذریعہ ہے۔

🔗 سرکاری MCP وسائل

  • 📘 MCP Documentation – تفصیلی ٹیوٹوریلز اور صارف گائیڈز
  • 📜 MCP Specification – پروٹوکول کی ساخت اور تکنیکی حوالہ جات
  • 📜 Original MCP Specification – پرانا تکنیکی حوالہ جات (مزید تفصیلات شامل ہو سکتی ہیں)
  • 🧑‍💻 MCP GitHub Repository – اوپن سورس SDKs، ٹولز، اور کوڈ نمونے
  • 🌐 MCP Community – مباحثوں میں شامل ہوں اور کمیونٹی میں حصہ لیں

MCP Dev Days 29-30 جولائی 2025 میں ہمارے ساتھ شامل ہوں

دو دن کی گہری تکنیکی بصیرت، کمیونٹی کنکشن، اور عملی سیکھنے کے لیے تیار ہو جائیں MCP Dev Days میں، جو ایک ورچوئل ایونٹ ہے جو Model Context Protocol (MCP) کے لیے وقف ہے — وہ ابھرتا ہوا معیار جو AI ماڈلز اور ان کے استعمال ہونے والے ٹولز کے درمیان پل کا کام دیتا ہے۔

➡️ MCP Dev Days کے لیے رجسٹر کریں

آپ MCP Dev Days کو ہمارے ایونٹ پیج پر رجسٹر کر کے دیکھ سکتے ہیں: https://aka.ms/mcpdevdays۔ وہاں سے آپ یوٹیوب یا ٹوئچ پر لائیو سٹریم میں شامل ہو سکیں گے۔ تمام مواد ریکارڈ کیا جائے گا اور بعد میں Microsoft Developer یوٹیوب چینل پر دستیاب ہوگا۔ ڈیموز کے لیے سورس کوڈ بھی GitHub پر دستیاب ہوگا۔

ایونٹ کی تفصیلات

  • تاریخیں: 29 جولائی (دن 1) اور 30 جولائی (دن 2)
  • وقت: روزانہ صبح 9:00 بجے PST
  • مقام: آن لائن – کہیں سے بھی شامل ہوں!

دن 1: MCP Productivity, DevTools، اور کمیونٹی:

یہ دن ڈویلپرز کو MCP کو اپنے ورک فلو میں استعمال کرنے کے قابل بنانے اور شاندار MCP کمیونٹی کا جشن منانے کے بارے میں ہے۔ ہم کمیونٹی کے ارکان اور شراکت داروں جیسے Arcade, Block, Okta، اور Neon کے ساتھ شامل ہوں گے تاکہ دیکھیں کہ وہ Microsoft کے ساتھ مل کر ایک کھلا، توسیع پذیر MCP ماحولیاتی نظام کیسے تشکیل دے رہے ہیں۔ VS Code، Visual Studio، GitHub Copilot، اور مقبول کمیونٹی ٹولز میں حقیقی دنیا کی ڈیموز
عملی، کانٹیکسٹ پر مبنی ڈویلپمنٹ ورک فلو
کمیونٹی کی قیادت میں سیشنز اور بصیرتیں
چاہے آپ MCP کے ساتھ ابھی شروع کر رہے ہوں یا پہلے ہی اس پر کام کر رہے ہوں، دن 1 آپ کو تحریک اور قابل عمل نکات فراہم کرے گا۔

دن 2: اعتماد کے ساتھ MCP سرورز بنائیں

یہ دن MCP بنانے والوں کے لیے ہے۔ ہم MCP سرورز بنانے اور MCP کو اپنے AI ورک فلو میں شامل کرنے کی حکمت عملیوں اور بہترین طریقوں میں گہرائی سے جائیں گے۔

موضوعات میں شامل ہیں:

  • MCP سرورز بنانا اور انہیں ایجنٹ تجربات میں شامل کرنا
  • پرامپٹ پر مبنی ترقی
  • سیکیورٹی کے بہترین طریقے
  • فنکشنز، ACA، اور API مینجمنٹ جیسے بلڈنگ بلاکس کا استعمال
  • رجسٹری کی ہم آہنگی اور ٹولنگ (1P + 3P)

اگر آپ ڈویلپر، ٹول بنانے والے، یا AI پروڈکٹ اسٹریٹیجسٹ ہیں، تو یہ دن آپ کے لیے ضروری بصیرت سے بھرپور ہے تاکہ آپ قابل توسیع، محفوظ، اور مستقبل کے لیے تیار MCP حل بنا سکیں۔

🧭 MCP نصاب کا جائزہ

📚 مکمل نصاب کی ساخت

ماڈیول موضوع وضاحت لنک
ماڈیول 1-3: بنیادی باتیں
00 MCP کا تعارف ماڈل کانٹیکسٹ پروٹوکول کا جائزہ اور AI پائپ لائنز میں اس کی اہمیت مزید پڑھیں
01 بنیادی تصورات کی وضاحت MCP کے بنیادی تصورات کی تفصیلی جانچ مزید پڑھیں
02 MCP میں سیکیورٹی سیکیورٹی کے خطرات اور بہترین طریقے مزید پڑھیں
03 MCP کے ساتھ شروعات ماحول کی تیاری، بنیادی سرورز/کلائنٹس، انٹیگریشن مزید پڑھیں
ماڈیول 3: اپنا پہلا سرور اور کلائنٹ بنائیں
3.1 پہلا سرور اپنا پہلا MCP سرور بنائیں رہنمائی
3.2 پہلا کلائنٹ ایک بنیادی MCP کلائنٹ تیار کریں رہنمائی
3.3 LLM کے ساتھ کلائنٹ بڑے زبان کے ماڈلز کو شامل کریں رہنمائی
3.4 VS Code انٹیگریشن VS Code میں MCP سرورز استعمال کریں رہنمائی
3.5 SSE سرور Server-Sent Events کے ذریعے سرورز بنائیں رہنمائی
3.6 HTTP سٹریمنگ MCP میں HTTP سٹریمنگ نافذ کریں رہنمائی
3.7 AI Toolkit MCP کے ساتھ AI Toolkit استعمال کریں رہنمائی
3.8 ٹیسٹنگ اپنے MCP سرور کے نفاذ کی جانچ کریں رہنمائی
3.9 تعیناتی MCP سرورز کو پروڈکشن میں تعینات کریں رہنمائی
ماڈیول 4-5: عملی اور اعلیٰ درجے کے موضوعات
04 عملی نفاذ SDKs، ڈیبگنگ، ٹیسٹنگ، دوبارہ استعمال کے قابل پرامپٹ ٹیمپلیٹس مزید پڑھیں
05 MCP میں اعلیٰ درجے کے موضوعات ملٹی موڈل AI، اسکیلنگ، انٹرپرائز استعمال مزید پڑھیں
5.1 Azure انٹیگریشن MCP کا Azure کے ساتھ انضمام رہنمائی
5.2 ملٹی موڈیلٹی متعدد موڈالٹیز کے ساتھ کام کرنا رہنمائی
5.3 OAuth2 ڈیمو OAuth2 تصدیق کا نفاذ رہنمائی
5.4 روٹ کانٹیکسٹس روٹ کانٹیکسٹس کو سمجھیں اور نافذ کریں رہنمائی
5.5 روٹنگ MCP روٹنگ کی حکمت عملیاں رہنمائی
5.6 سیمپلنگ MCP میں سیمپلنگ کی تکنیکیں رہنمائی
5.7 اسکیلنگ MCP نفاذ کو اسکیل کریں رہنمائی
5.8 سیکیورٹی اعلیٰ درجے کی سیکیورٹی کے پہلو رہنمائی
5.9 ویب سرچ ویب سرچ کی صلاحیتیں نافذ کریں رہنمائی
5.10 ریئل ٹائم سٹریمنگ ریئل ٹائم سٹریمنگ کی فعالیت بنائیں رہنمائی
5.11 ریئل ٹائم سرچ ریئل ٹائم سرچ نافذ کریں رہنمائی
5.12 Entra ID Auth Microsoft Entra ID کے ساتھ توثیق Guide
5.13 Foundry Integration Azure AI Foundry کے ساتھ انضمام Guide
5.14 Context Engineering مؤثر کانٹیکسٹ انجینئرنگ کی تکنیکیں Guide
Module 6-10: Community & Best Practices
06 کمیونٹی میں شراکتیں MCP ماحولیاتی نظام میں حصہ ڈالنے کا طریقہ Guide
07 ابتدائی اپنانے سے بصیرتیں حقیقی دنیا کی نفاذ کی کہانیاں Guide
08 MCP کے لیے بہترین طریقے کارکردگی، فالٹ ٹولیرنس، لچک Guide
09 MCP کیس اسٹڈیز عملی نفاذ کی مثالیں Guide
10 ہینڈز آن ورکشاپ AI Toolkit کے ساتھ MCP سرور کی تعمیر Lab

💻 نمونہ کوڈ پروجیکٹس

بنیادی MCP کیلکولیٹر کے نمونے

Language Description Link
C# MCP سرور کی مثال View Code
Java MCP کیلکولیٹر View Code
JavaScript MCP ڈیمو View Code
Python MCP سرور View Code
TypeScript MCP کی مثال View Code

اعلیٰ درجے کی MCP نفاذات

Language Description Link
C# اعلیٰ درجے کا نمونہ View Code
Java کنٹینر ایپ کی مثال View Code
JavaScript اعلیٰ درجے کا نمونہ View Code
Python پیچیدہ نفاذ View Code
TypeScript کنٹینر نمونہ View Code

🎯 MCP سیکھنے کے لیے ضروریات

اس نصاب سے زیادہ سے زیادہ فائدہ اٹھانے کے لیے، آپ کے پاس ہونا چاہیے:

  • کم از کم ایک زبان میں بنیادی پروگرامنگ کا علم: C#, Java, JavaScript, Python، یا TypeScript

  • کلائنٹ-سرور ماڈل اور APIs کی سمجھ

  • REST اور HTTP کے تصورات سے واقفیت

  • (اختیاری) AI/ML کے تصورات کا پس منظر

  • ہماری کمیونٹی مباحثوں میں شامل ہو کر مدد حاصل کرنا

📚 مطالعہ گائیڈ اور وسائل

یہ ریپوزیٹری آپ کی رہنمائی اور مؤثر سیکھنے کے لیے کئی وسائل فراہم کرتی ہے:

مطالعہ گائیڈ

ایک جامع مطالعہ گائیڈ دستیاب ہے جو آپ کو اس ریپوزیٹری میں مؤثر طریقے سے رہنمائی فراہم کرتی ہے۔ اس گائیڈ میں شامل ہیں:

  • تمام موضوعات کا بصری نصاب نقشہ
  • ہر سیکشن کی تفصیلی تقسیم
  • نمونہ پروجیکٹس کے استعمال کی رہنمائی
  • مختلف مہارت کی سطحوں کے لیے تجویز کردہ سیکھنے کے راستے
  • آپ کے سیکھنے کے سفر کو مکمل کرنے کے لیے اضافی وسائل

تبدیلیوں کا ریکارڈ

ہم ایک تفصیلی چینج لاگ برقرار رکھتے ہیں جو نصاب کے مواد میں تمام اہم اپ ڈیٹس کو ٹریک کرتا ہے، بشمول:

  • نئے مواد کا اضافہ
  • ساختی تبدیلیاں
  • فیچر کی بہتریاں
  • دستاویزات کی تازہ کاری

🛠️ اس نصاب کو مؤثر طریقے سے استعمال کرنے کا طریقہ

اس گائیڈ کے ہر سبق میں شامل ہیں:

  1. MCP تصورات کی واضح وضاحتیں
  2. متعدد زبانوں میں لائیو کوڈ مثالیں
  3. حقیقی MCP ایپلیکیشنز بنانے کی مشقیں
  4. اعلیٰ درجے کے سیکھنے والوں کے لیے اضافی وسائل

🌟 کمیونٹی کا شکریہ

Microsoft Valued Professional Shivam Goyal کا اہم کوڈ نمونوں میں تعاون کرنے کے لیے شکریہ۔

📜 لائسنس کی معلومات

یہ مواد MIT License کے تحت لائسنس یافتہ ہے۔ شرائط و ضوابط کے لیے LICENSE دیکھیں۔

🤝 تعاون کے اصول

یہ پروجیکٹ تعاون اور تجاویز کا خیرمقدم کرتا ہے۔ زیادہ تر تعاون کے لیے آپ کو ایک Contributor License Agreement (CLA) پر رضامندی دینی ہوتی ہے جس میں آپ یہ اعلان کرتے ہیں کہ آپ کے پاس اپنا تعاون فراہم کرنے کے حقوق ہیں اور آپ واقعی ہمیں ان حقوق کی اجازت دیتے ہیں۔ تفصیلات کے لیے ملاحظہ کریں https://cla.opensource.microsoft.com۔

جب آپ پل ریکویسٹ جمع کرواتے ہیں، تو CLA بوٹ خود بخود فیصلہ کرے گا کہ آیا آپ کو CLA فراہم کرنے کی ضرورت ہے اور PR کو مناسب طریقے سے نشان زد کرے گا (مثلاً، اسٹیٹس چیک، تبصرہ)۔ بس بوٹ کی ہدایات پر عمل کریں۔ آپ کو یہ عمل تمام ریپوز میں صرف ایک بار کرنا ہوگا جو ہمارے CLA استعمال کرتے ہیں۔

اس پروجیکٹ نے Microsoft Open Source Code of Conduct کو اپنایا ہے۔ مزید معلومات کے لیے Code of Conduct FAQ دیکھیں یا کسی اضافی سوال یا تبصرے کے لیے opencode@microsoft.com سے رابطہ کریں۔

📂 ریپوزیٹری کی ساخت

ریپوزیٹری مندرجہ ذیل طریقے سے منظم ہے:

  • Core Curriculum (00-10): مرکزی مواد جو دس متسلسل ماڈیولز میں منظم ہے
  • images/: نصاب میں استعمال ہونے والے خاکے اور تصاویر
  • translations/: خودکار ترجموں کے ساتھ کثیراللسانی معاونت
  • translated_images/: خاکوں اور تصاویر کے مقامی ورژن
  • study_guide.md: ریپوزیٹری میں رہنمائی کے لیے جامع گائیڈ
  • changelog.md: نصاب کے مواد میں تمام اہم تبدیلیوں کا ریکارڈ
  • mcp.json: MCP وضاحت کے لیے کنفیگریشن فائل
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: پروجیکٹ کے حکمرانی کے دستاویزات

🎒 دیگر کورسز

ہماری ٹیم دیگر کورسز بھی تیار کرتی ہے! دیکھیں:

™️ ٹریڈ مارک نوٹس

یہ پروجیکٹ ممکنہ طور پر پروجیکٹس، مصنوعات، یا خدمات کے ٹریڈ مارکس یا لوگوز پر مشتمل ہو سکتا ہے۔ Microsoft کے ٹریڈ مارکس یا لوگوز کا مجاز استعمال Microsoft's Trademark & Brand Guidelines کے تابع ہے اور ان کی پیروی کرنا ضروری ہے۔ اس پروجیکٹ کے ترمیم شدہ ورژنز میں Microsoft کے ٹریڈ مارکس یا لوگوز کا استعمال الجھن پیدا نہیں کرے گا اور نہ ہی Microsoft کی سرپرستی کا تاثر دے گا۔ تیسری پارٹی کے ٹریڈ مارکس یا لوگوز کا استعمال ان تیسری پارٹیوں کی پالیسیوں کے تابع ہے۔

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