Skip to content

Latest commit

 

History

History
268 lines (226 loc) · 12.7 KB

File metadata and controls

268 lines (226 loc) · 12.7 KB

ماڈل کانٹیکسٹ پروٹوکول (MCP) برائے مبتدیان - مطالعہ گائیڈ

یہ مطالعہ گائیڈ "Model Context Protocol (MCP) for Beginners" نصاب کے لیے ریپوزیٹری کی ساخت اور مواد کا جائزہ فراہم کرتی ہے۔ اس گائیڈ کو استعمال کریں تاکہ ریپوزیٹری میں مؤثر طریقے سے نیویگیٹ کیا جا سکے اور دستیاب وسائل سے بھرپور فائدہ اٹھایا جا سکے۔

ریپوزیٹری کا جائزہ

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

بصری نصاب کا نقشہ

mindmap
  root((MCP for Beginners))
    00. Introduction
      ::icon(fa fa-book)
      (Protocol Overview)
      (Standardization)
      (Use Cases)
    01. Core Concepts
      ::icon(fa fa-puzzle-piece)
      (Client-Server Architecture)
      (Protocol Components)
      (Messaging Patterns)
    02. Security
      ::icon(fa fa-shield)
      (Threat Models)
      (Best Practices)
      (Auth Strategies)
    03. Getting Started
      ::icon(fa fa-rocket)
      (First Server)
      (Client)
      (LLM Client)
      (VS Code Integration)
      (SSE Server)
      (HTTP Streaming)
      (AI Toolkit)
      (Testing)
      (Deployment)
    04. Practical Implementation
      ::icon(fa fa-code)
      (SDKs)
      (Testing/Debugging)
      (Prompt Templates)
      (Sample Projects)
    05. Advanced Topics
      ::icon(fa fa-graduation-cap)
      (Context Engineering)
      (Foundry Integration)
      (Multi-modal AI)
      (OAuth2 Demo)
      (Real-time Search)
      (Streaming)
      (Root Contexts)
      (Routing)
      (Sampling)
      (Scaling)
      (Security)
      (Entra ID)
      (Web Search)
      
    06. Community
      ::icon(fa fa-users)
      (Code Contributions)
      (Documentation)
      (MCP Clients)
      (MCP Servers)
      (Image Generation)
    07. Early Adoption
      ::icon(fa fa-lightbulb)
      (Real-world Examples)
      (Deployment Stories)
      (Future Roadmap)
    08. Best Practices
      ::icon(fa fa-check)
      (Performance)
      (Fault Tolerance)
      (Resilience)
    09. Case Studies
      ::icon(fa fa-file-text)
      (API Management)
      (Travel Agent)
      (Azure DevOps)
      (Documentation MCP)
    10. Hands-on Workshop
      ::icon(fa fa-laptop)
      (AI Toolkit Integration)
      (Custom Server Development)
      (Production Deployment)
Loading

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

ریپوزیٹری کو دس اہم حصوں میں منظم کیا گیا ہے، ہر ایک MCP کے مختلف پہلوؤں پر توجہ مرکوز کرتا ہے:

  1. تعارف (00-Introduction/)

    • Model Context Protocol کا تعارف
    • AI پائپ لائنز میں معیاری بنانے کی اہمیت
    • عملی استعمال کے کیسز اور فوائد
  2. بنیادی تصورات (01-CoreConcepts/)

    • کلائنٹ-سرور آرکیٹیکچر
    • پروٹوکول کے کلیدی اجزاء
    • MCP میں میسجنگ کے پیٹرنز
  3. سیکیورٹی (02-Security/)

    • MCP پر مبنی سسٹمز میں سیکیورٹی خطرات
    • محفوظ نفاذ کے بہترین طریقے
    • توثیق اور اجازت کے حکمت عملی
  4. شروع کرنا (03-GettingStarted/)

    • ماحول کی ترتیب اور کنفیگریشن
    • بنیادی MCP سرورز اور کلائنٹس کی تخلیق
    • موجودہ ایپلیکیشنز کے ساتھ انضمام
    • شامل سیکشنز:
      • پہلا سرور نفاذ
      • کلائنٹ کی ترقی
      • LLM کلائنٹ انضمام
      • VS Code انٹیگریشن
      • Server-Sent Events (SSE) سرور
      • HTTP اسٹریمنگ
      • AI Toolkit انضمام
      • ٹیسٹنگ کی حکمت عملی
      • تعیناتی کے رہنما اصول
  5. عملی نفاذ (04-PracticalImplementation/)

    • مختلف پروگرامنگ زبانوں میں SDKs کا استعمال
    • ڈیبگنگ، ٹیسٹنگ، اور ویلیڈیشن کی تکنیکیں
    • دوبارہ استعمال کے قابل پرامپٹ ٹیمپلیٹس اور ورک فلو تیار کرنا
    • نفاذ کی مثالوں کے ساتھ نمونہ پروجیکٹس
  6. جدید موضوعات (05-AdvancedTopics/)

    • کانٹیکسٹ انجینئرنگ کی تکنیکیں
    • Foundry ایجنٹ انضمام
    • ملٹی موڈل AI ورک فلو
    • OAuth2 توثیق کے مظاہرے
    • حقیقی وقت کی تلاش کی صلاحیتیں
    • حقیقی وقت کی اسٹریمنگ
    • روٹ کانٹیکسٹس کا نفاذ
    • روٹنگ کی حکمت عملی
    • سیمپلنگ کی تکنیکیں
    • اسکیلنگ کے طریقے
    • سیکیورٹی کے پہلو
    • Entra ID سیکیورٹی انضمام
    • ویب سرچ انٹیگریشن
  7. کمیونٹی کی شراکتیں (06-CommunityContributions/)

    • کوڈ اور دستاویزات میں تعاون کیسے کریں
    • GitHub کے ذریعے تعاون
    • کمیونٹی کی جانب سے بہتریاں اور تاثرات
    • مختلف MCP کلائنٹس کا استعمال (Claude Desktop, Cline, VSCode)
    • مقبول MCP سرورز کے ساتھ کام کرنا بشمول امیج جنریشن
  8. ابتدائی اپنانے سے حاصل شدہ اسباق (07-LessonsfromEarlyAdoption/)

    • حقیقی دنیا میں نفاذ اور کامیابی کی کہانیاں
    • MCP پر مبنی حل کی تعمیر اور تعیناتی
    • رجحانات اور مستقبل کا روڈ میپ
  9. بہترین طریقے (08-BestPractices/)

    • کارکردگی کی بہتری اور اصلاح
    • فالٹ ٹولرینٹ MCP سسٹمز کی ڈیزائننگ
    • ٹیسٹنگ اور مزاحمت کی حکمت عملی
  10. کیس اسٹڈیز (09-CaseStudy/)

    • کیس اسٹڈی: Azure API Management انضمام
    • کیس اسٹڈی: ٹریول ایجنٹ نفاذ
    • کیس اسٹڈی: Azure DevOps کا YouTube کے ساتھ انضمام
    • تفصیلی دستاویزات کے ساتھ نفاذ کی مثالیں
  11. عملی ورکشاپ (10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/)

    • MCP اور AI Toolkit کو یکجا کرنے والی جامع عملی ورکشاپ
    • ذہین ایپلیکیشنز کی تعمیر جو AI ماڈلز کو حقیقی دنیا کے ٹولز سے جوڑتی ہیں
    • بنیادی اصول، کسٹم سرور کی ترقی، اور پروڈکشن تعیناتی کی حکمت عملیوں پر مشتمل عملی ماڈیولز
    • مرحلہ وار ہدایات کے ساتھ لیب پر مبنی سیکھنے کا طریقہ

اضافی وسائل

ریپوزیٹری میں معاون وسائل شامل ہیں:

  • Images فولڈر: نصاب میں استعمال ہونے والے خاکے اور تصاویر
  • Translations: دستاویزات کے خودکار ترجمے کے ساتھ کثیراللسانی معاونت
  • سرکاری MCP وسائل:

اس ریپوزیٹری کو کیسے استعمال کریں

  1. متسلسل سیکھنا: منظم سیکھنے کے لیے ابواب کو ترتیب سے (00 سے 10 تک) پڑھیں۔
  2. زبان پر مخصوص توجہ: اگر آپ کسی خاص پروگرامنگ زبان میں دلچسپی رکھتے ہیں تو اپنی پسندیدہ زبان میں نفاذ کے لیے samples ڈائریکٹریز کو دیکھیں۔
  3. عملی نفاذ: اپنے ماحول کی ترتیب کے لیے "Getting Started" سیکشن سے آغاز کریں اور اپنا پہلا MCP سرور اور کلائنٹ بنائیں۔
  4. جدید دریافت: بنیادی باتوں میں مہارت حاصل کرنے کے بعد جدید موضوعات میں غوطہ لگائیں تاکہ اپنی معلومات کو بڑھایا جا سکے۔
  5. کمیونٹی میں شمولیت: GitHub مباحثوں اور Discord چینلز کے ذریعے MCP کمیونٹی میں شامل ہوں تاکہ ماہرین اور دیگر ڈویلپرز سے رابطہ قائم کیا جا سکے۔

MCP کلائنٹس اور ٹولز

نصاب مختلف MCP کلائنٹس اور ٹولز کا احاطہ کرتا ہے:

  1. سرکاری کلائنٹس:

    • Visual Studio Code
    • MCP in Visual Studio Code
    • Claude Desktop
    • Claude in VSCode
    • Claude API
  2. کمیونٹی کلائنٹس:

    • Cline (ٹرمینل بیسڈ)
    • Cursor (کوڈ ایڈیٹر)
    • ChatMCP
    • Windsurf
  3. MCP مینجمنٹ ٹولز:

    • MCP CLI
    • MCP Manager
    • MCP Linker
    • MCP Router

مقبول MCP سرورز

ریپوزیٹری مختلف MCP سرورز متعارف کراتی ہے، جن میں شامل ہیں:

  1. سرکاری ریفرنس سرورز:

    • Filesystem
    • Fetch
    • Memory
    • Sequential Thinking
  2. امیج جنریشن:

    • Azure OpenAI DALL-E 3
    • Stable Diffusion WebUI
    • Replicate
  3. ترقیاتی ٹولز:

    • Git MCP
    • Terminal Control
    • Code Assistant
  4. خصوصی سرورز:

    • Salesforce
    • Microsoft Teams
    • Jira & Confluence

تعاون

یہ ریپوزیٹری کمیونٹی کی شراکتوں کا خیرمقدم کرتی ہے۔ MCP ایکو سسٹم میں مؤثر تعاون کے لیے کمیونٹی کی شراکتیں سیکشن دیکھیں۔

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

تاریخ تبدیلیاں
16 جولائی، 2025 - موجودہ مواد کی عکاسی کے لیے ریپوزیٹری کی ساخت کو اپ ڈیٹ کیا گیا
- MCP کلائنٹس اور ٹولز سیکشن شامل کیا گیا
- مقبول MCP سرورز سیکشن شامل کیا گیا
- تمام موجودہ موضوعات کے ساتھ بصری نصاب کا نقشہ اپ ڈیٹ کیا گیا
- تمام خصوصی شعبوں کے ساتھ جدید موضوعات سیکشن کو بہتر بنایا گیا
- حقیقی مثالوں کی عکاسی کے لیے کیس اسٹڈیز کو اپ ڈیٹ کیا گیا
- MCP کی ابتدا کو Anthropic کی تخلیق کے طور پر واضح کیا گیا
11 جون، 2025 - مطالعہ گائیڈ کی ابتدائی تخلیق
- بصری نصاب کا نقشہ شامل کیا گیا
- ریپوزیٹری کی ساخت کا خاکہ پیش کیا گیا
- نمونہ پروجیکٹس اور اضافی وسائل شامل کیے گئے

یہ مطالعہ گائیڈ 16 جولائی، 2025 کو اپ ڈیٹ کیا گیا تھا اور اس تاریخ تک ریپوزیٹری کا جائزہ فراہم کرتا ہے۔ اس تاریخ کے بعد ریپوزیٹری کا مواد اپ ڈیٹ ہو سکتا ہے۔

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