Files

T

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

68 KiB

Raw Permalink Blame History

تبدیل کی تاریخ: MCP برائے ابتدائیوں کا نصاب

یہ دستاویز ماڈل کانٹیکسٹ پروٹوکول (MCP) برائے ابتدائیوں کے نصاب میں کی جانے والی تمام اہم تبدیلیوں کا ریکارڈ ہے۔ تبدیلیاں الٹی ترتیب میں دستاویز کی گئی ہیں (نئی تبدیلیاں سب سے پہلے)۔

24 جون، 2026

نیا سبق: کوپائلٹ ایپ میں MCP کا استعمال

ٹولنگ سیکشن ٹولنگ سیکشن شامل کیا گیا۔
کوپائلٹ ایپ میں MCP

16 جون، 2026

MCP وضاحت کی مماثلت اور نمونہ توثیق

نصاب کو موجودہ MCP Specification 2025-11-25 اور تازہ ترین سرکاری SDKs کے خلاف جانچا، پھر باقی ماندہ پرانی وضاحت کے حوالے درست کیے اور تصدیق کی کہ مرکزی نمونے اب بھی تعمیر اور چلتے ہیں۔

وضاحت کے ورژن کی اصلاح (2025-06-18 / 2025-03-26 → 2025-11-25)

انگریزی مواد کو اپڈیٹ کیا جہاں اب بھی پرانے سپیک ریویژن کو موجودہ/تازہ ترین معیار بتایا گیا تھا، اور روابط کو canonical modelcontextprotocol.io وضاحت کے راستوں کی طرف منتقل کیا گیا:

05-AdvancedTopics/mcp-security/README.md: "موجودہ معیار" بینر، تعارف، بنیادی سیکیورٹی اصولوں کا عنوان، لازمی تقاضوں کا عنوان، Microsoft Entra ID سیکشن، حوالہ جات اور ذرائع کے روابط، اور اختتامی سیکیورٹی نوٹس (8 حوالے) کو 2025-11-25 پر اپڈیٹ کیا
05-AdvancedTopics/mcp-transport/README.md: اضافی ذرائع کے وضاحت کے لنک اور "موجودہ معیار" بینر کو 2025-11-25 پر اپڈیٹ کیا
05-AdvancedTopics/mcp-realtimesearch/README.md: پرانے 2025-03-26 سیکیورٹی اور اعتماد کے لنک کو موجودہ 2025-11-25 سیکیورٹی بہترین طریقہ کار کے صفحے سے تبدیل کیا
03-GettingStarted/14-sampling/README.md: سرکاری سیمپلنگ دستاویزات کے لنک کو 2025-11-25 پر اپڈیٹ کیا
03-GettingStarted/05-stdio-server/README.md: حالیہ "موجودہ MCP وضاحت" کے حوالہ کو حالیہ زمانے میں اپڈیٹ کیا اور اضافی ذرائع کے وضاحت لنک کو 2025-11-25 پر اپڈیٹ کیا (تاریخی SSE-ڈیپریکیشن نوٹس درستگی کے لیے برقرار رکھا گیا)

ڈیپنڈنسی پن مماثلت (ورژن کے خلاء کو بند کرنا)

پرانی SDK پن کو اپ گریڈ کیا تاکہ ہر نمونہ موجودہ MCP ریلیز کے مطابق ہو، ریپو بھر کے کنوینشن سے ہم آہنگ:

03-GettingStarted/05-stdio-server/solution/typescript/package.json: @modelcontextprotocol/sdk کو ^1.8.0 سے بڑھا کر >=1.26.0 کیا اور زنگ آلود "updated for MCP 2025-06-18" پیکیج کی وضاحت کو "aligned with MCP Specification 2025-11-25" میں اپڈیٹ کیا
10-StreamliningAIWorkflows.../lab3/code/weather_mcp/pyproject.toml اور lab4/code/github_mcp_server/pyproject.toml: عین مطابق پن mcp==1.23.0 کو mcp>=1.26.0 میں اپ گریڈ کیا؛ دونوں uv.lock فائلیں (uv lock) دوبارہ جنریٹ کی گئیں تاکہ لاک فائلیں موجودہ mcp 1.27.2 کے مطابق حل ہوں اور مینیفیسٹ کے ساتھ ہم آہنگ رہیں

نصاب کے خلاء کا تجزیہ — تازہ ترین وضاحت کی خصوصیات کا احاطہ

تصدیق کی کہ نصاب میں پہلے سے ہی MCP 2025-11-25 میں متعارف اور وسعت دی گئی تمام بنیادی خصوصیات شامل ہیں، لہذا کوئی مواد کا خلا باقی نہیں:

Sampling: سبق 03-GettingStarted/14-sampling ساتھ ساتھ 05-AdvancedTopics/mcp-sampling
Elicitation (URL موڈ سمیت): 01-CoreConcepts اور 05-AdvancedTopics/mcp-protocol-features میں دستاویزی
Roots: 00-Introduction، 01-CoreConcepts، اور 05-AdvancedTopics/mcp-root-contexts میں دستاویزی
Tasks (تجرباتی، طویل دورانیے کے آپریشنز): 01-CoreConcepts اور 05-AdvancedTopics/mcp-protocol-features میں دستاویزی
ٹول اناٹیشنز (readOnlyHint / destructiveHint): 01-CoreConcepts اور 05-AdvancedTopics/mcp-protocol-features میں دستاویزی

سیکیورٹی مضبوطی اور ڈیپنڈنسی خطرات کی اصلاح

ہر ڈیپنڈنسی مینیفیسٹ اور نمونہ سورس کوڈ پر مکمل سیکیورٹی جائزہ لیا، پھر تمام رپورٹ شدہ npm مشورے اور ایک کوڈ سطح کی دریافت کو درست کیا۔ اصلاح کے بعد، npm audit نے ہر جائزے والے فولڈر میں 0 خطرات رپورٹ کیے۔

npm ڈیپنڈنسی کمزوریاں (غیر مستقیم) — درست

تمام 15 کمٹ شدہ package-lock.json فائلوں کا جائزہ لیا۔ کمزوریاں صرف غیر مستقیم ڈیپنڈنسیز تک محدود تھیں جو MCP Inspector ڈویلپمنٹ ٹول، OpenAI کلائنٹ، اور MCP SDK سے آئی تھیں؛ یہ سب بغیر نمونوں کو توڑے حل ہو گئی ہیں:

10-StreamliningAIWorkflows.../lab4/code/github_mcp_server/inspector اور lab3/code/weather_mcp/inspector: @modelcontextprotocol/inspector (0.16.6 / 0.14.1 → 0.22.0) کو اپ گریڈ کیا، جس نے bundled ajv, brace-expansion, diff, path-to-regexp اور ws کی مشوروں کو ختم کیا۔ npm overrides شامل کیا جو patched shell-quote@1.8.4 کو زبردستی استعمال کرتا ہے تاکہ concurrently کی کریٹیکل مشورہ ختم ہو جائے؛ دونوں لاک فائلیں دوبارہ جنریٹ کی گئیں (اب 0 خطرات)
03-GettingStarted/samples/typescript: npm audit fix نے غیر مستقیم qs (درمیانہ خطرہ) کو patched ریلیز پر اپ ڈیٹ کیا
03-GettingStarted/samples/javascript: npm audit fix نے غیر مستقیم hono (درمیانہ خطرہ) کو patched ریلیز پر اپ ڈیٹ کیا
03-GettingStarted/03-llm-client/solution/typescript: npm audit fix نے غیر مستقیم form-data (اعلی خطرہ) کو patched ریلیز پر اپ ڈیٹ کیا
03-GettingStarted/11-simple-auth/solution/typescript: گمشدہ package-lock.json جنریٹ کی تاکہ پروجیکٹ کی دوبارہ تکرار اور جانچ ہو سکے (0 خطرات)

کوڈ سطح کی سیکیورٹی اصلاح (OWASP A03: Injection)

10-StreamliningAIWorkflows.../lab4/code/github_mcp_server/src/server.py: open_in_vscode ٹول سے shell=True ہٹا دیا گیا۔ پہلے کا subprocess.run(["start", "", vscode_path, folder_path], shell=True) فولڈر کے راستے میں شیل میٹا کریکٹرز کو cmd.exe کے ذریعے سمجھنے دیتا تھا (کمانڈ انجیکشن کا امکان)۔ اب یہ براہ راست حل شدہ Code.exe کو فولڈر کو دلیل کے طور پر دے کر لانچ کرتا ہے — بغیر شیل — جو فنکشنل طور پر مساوی اور محفوظ ہے۔

پائتھن ڈیپنڈنسی آڈٹ

ہر Python requirements سیٹ کا pip-audit کے ساتھ جائزہ لیا۔ 05-AdvancedTopics اور 03-GettingStarted/samples/python نے کوئی معلوم خطرہ نہیں رپورٹ کیا (ان کے mcp / httpx / pydantic / python-dotenv ورژن موجودہ patched ریلیز پر حل ہوتے ہیں)
09-CaseStudy/docs-mcp/solution/python/requirements.txt: pip-audit نے غیر مستقیم ڈیپنڈنسی werkzeug 3.1.1 کو تین safe_join ونڈوز ڈیوائس نیم DoS مشوروں کے ساتھ نشان زد کیا — CVE-2025-66221, CVE-2026-21860, اور CVE-2026-27199 (سب 3.1.6 میں درست)۔ ایک مخصوص سیکیورٹی پن werkzeug>=3.1.6 شامل کیا تاکہ patched ریلیز حل ہو؛ اس بات کی تصدیق کی کہ کنسٹرینٹ chainlit / mcp / semantic-kernel اسٹیک کے ساتھ صاف حل ہوتا ہے۔

پروڈکٹ نام کی تبدیلی

مائیکروسافٹ کے پروڈکٹ ری برانڈنگ کے مطابق نصاب کے تمام مواد کو اپ ڈیٹ کیا گیا ہے:

Azure AI Foundry → Microsoft Foundry

SUPPORT.md: Discord کمیونٹی کا لنک اپڈیٹ کیا
AGENTS.md: Discord سرور کا حوالہ اپ ڈیٹ کیا
README.md: ٹیکنالوجی ایکوسسٹم کے حوالہ جات اپ ڈیٹ کیے
study_guide.md: کیس اسٹڈی حوالہ جات اپ ڈیٹ کیے
05-AdvancedTopics/README.md: ماڈیول 5.13 کا عنوان اور تفصیل اپ ڈیٹ کی گئی
05-AdvancedTopics/mcp-integration/README.md: سیکشن ہیڈر اور تفصیل اپ ڈیٹ کی گئی
05-AdvancedTopics/mcp-foundry-agent-integration/README.md: پورے ماڈیول کے عنوان اور مواد کی تجدید
05-AdvancedTopics/mcp-security-entra/README.md: کراس ریفرنس لنک اپ ڈیٹ کیا
07-LessonsfromEarlyAdoption/README.md: کیس اسٹڈی حوالہ جات اپ ڈیٹ کیے
07-LessonsfromEarlyAdoption/microsoft-mcp-servers.md: سیکشن 9 کے ہیڈر، بیجز، اور صلاحیتیں اپ ڈیٹ کیں
08-BestPractices/README.md: Discord کمیونٹی کا لنک اپ ڈیٹ کیا
09-CaseStudy/docs-mcp/solution/scenario3/README.md: Discord چینل کا حوالہ اپ ڈیٹ کیا
09-CaseStudy/docs-mcp/solution/python/README.md: ماڈل ڈپلوئمنٹ کا حوالہ اپ ڈیٹ کیا
11-MCPServerHandsOnLabs/00-Introduction/README.md: AI سروسز کی جدول اپ ڈیٹ کی گئی
11-MCPServerHandsOnLabs/03-Setup/README.md: وسائل کے حوالہ جات اپ ڈیٹ کیے

AI Toolkit / AITK → Microsoft Foundry Toolkit Extension for VS Code

README.md: مرکزی نصاب کے حوالہ جات اپ ڈیٹ کیے
10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/README.md: ماڈیول کا عنوان، جائزہ، اور تمام ماڈیول ہیڈرز اپ ڈیٹ کیے
10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab1/README.md: عنوان، تعلیماتی مقاصد، سیٹ اپ کی ہدایات، اور وسائل اپ ڈیٹ کیے
10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab2/README.md: عنوان، تعلیماتی مقاصد، MCP ہوسٹس کی جدول، اور کراس ریفرنسز اپ ڈیٹ کیے
10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab3/README.md: عنوان، بیجز، شرطیں، اور وسائل اپ ڈیٹ کیے
10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab3/code/weather_mcp/README.md: ایجنٹ بیلڈر حوالہ جات اور تاثرات کا لنک اپ ڈیٹ کیا گیا
10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab4/README.md: شرائط اور ایکسٹینشن حوالہ جات اپ ڈیٹ کیے

11 اپریل، 2026

نیا سبق، دستاویزی اصلاحات، اور ڈیپنڈنسی اپ ڈیٹس

نیا نصابی مواد شامل کیا گیا

ماڈیول 05 - جدید موضوعات

سبق 5.17: MCP کے ساتھ مخالفانہ ملٹی ایجنٹ استدلال (05-AdvancedTopics/mcp-adversarial-agents/README.md): مخالفانہ مباحثے کے نمونے کے لیے نیا جامع رہنما ملٹی ایجنٹ سسٹمز کے لیے
- مرمیڈ آرکیٹیکچر ڈایاگرام: دو ایجنٹ → مشترکہ MCP سرور → مباحثے کی ٹرانسکرپٹ → جج → فیصلہ
- مشترکہ MCP ٹول سرور (web_search + run_python) پائتھن اور ٹائپ اسکرپٹ میں نافذ کیا گیا
- متضاد نظام پرامپٹس (کے لیے / خلاف / جج) واضح ٹول استعمال کی شرائط کے ساتھ
- مباحثہ آرکیسٹریٹر پائتھن، ٹائپ اسکرپٹ، اور C# میں جو راؤنڈز اور دلائل کے راستے سنبھالتا ہے
- MCP ClientSession آرکیٹریٹر کو اصل ٹول کالز کے لیے وائرنگ
- استعمال کا جدول (ہیلوسینیشن کی شناخت، خطرہ ماڈلنگ، API ڈیزائن جائزہ، حقائق کی تصدیق، ٹیکنالوجی کی انتخاب)
- سیکیورٹی پہلو: سینڈباکسڈ اجرا، ٹول کال کی توثیق، ریٹ لمٹنگ، آڈٹ لاگنگ
- تین عملی منظرناموں کے ساتھ منظم مشق (کوڈ جائزہ، آرکیٹیکچر فیصلہ، مواد کی نگرانی)

دستاویزی اصلاحات

ماڈیول 03 - شروع کرنا

05-stdio-server/README.md: نامکمل ٹائپ اسکرپٹ stdio سرور کی مثال درست کی گئی — ٹرانسپورٹ کی کمی کو پورا کیا گیا (new StdioServerTransport()) اور server.connect(transport) کال شامل کی گئی تاکہ پائتھن اور .NET کی مثالوں سے میل کھائے
14-sampling/README.md: ٹائپوز درست کی گئی — "Sampling is an davanced features" کو "Sampling is an advanced feature" میں درست کیا گیا

نصاب کی اپ ڈیٹس

مرکزی README.md

نصاب کی میز میں انٹری 5.17 (MCP کے ساتھ مخالفانہ ملٹی ایجنٹ استدلال) نئے سبق کے براہ راست لنک کے ساتھ شامل کی گئی

05-AdvancedTopics/README.md

سبق 5.17 کی قطار کو سبقوں کی میز میں شامل کیا گیا

study_guide.md

جدید موضوعات کے ذہنی نقشے اور نثری وضاحت میں مخالفانہ ملٹی ایجنٹ استدلال کا موضوع شامل کیا گیا

کوڈ اور سیکیورٹی اصلاحات

ماڈیول 05 - مخالف ایجنٹس (mcp-adversarial-agents)

سیکیورٹی کی مرمت — کمانڈ انجیکشن: ٹائپ اسکرپٹ کے run_python ٹول میں execSync شیل انٹرپولیشن کو execFile + promisify سے تبدیل کر دیا گیا، جس سے کمانڈ انجیکشن کا خطرہ ختم ہو گیا ہے (اب LLM کنٹرولڈ کوڈ literal argv عنصر کے طور پر پاس کیا جاتا ہے جس میں شیل شامل نہیں ہوتی)
MCP ٹول لوپ وائرنگ: پائتھون ڈیبیٹ آرکیسٹریٹر کو AsyncAnthropic کلائنٹ (بلاکنگ synchronous Anthropic کی جگہ) استعمال کرنے، ہر ایجنٹ ٹرن کو براہِ راست live ClientSession فراہم کرنے، ہر دورانیے میں session.list_tools() کے ذریعے ٹول ڈیفینیشنز حاصل کرنے، اور session.call_tool() کے ذریعے tool_use بلاکس کو ماڈل کے فائنل ٹیکسٹ جواب دینے تک لوپ میں بھیجنے کے لیے اپ ڈیٹ کیا گیا

انحصار کی تازہ کاری

متعدد پیکیجز (03-GettingStarted، 04-PracticalImplementation، 10-StreamliningAIWorkflows) میں hono کو 4.12.12 تک بڑھایا گیا
ٹائپ اسکرپٹ پیکیجز میں @hono/node-server کو 1.19.11 سے 1.19.13 تک بڑھایا گیا
پائتھون پیکیجز (10-StreamliningAIWorkflows لیبز 3 اور 4) میں cryptography کو 46.0.5 سے 46.0.7 تک بڑھایا گیا
10-StreamliningAIWorkflows انسپیکٹر میں lodash کو 4.17.23 سے 4.18.1 تک بڑھایا گیا

ترجمہ جات

48+ زبانوں کے لیے ترجمہ جات کو تازہ ترین سورس تبدیلیوں کے مطابق ہموار کیا گیا (i18n اپ ڈیٹ)

5 فروری، 2026

ریپوزیٹری کی وسیع سطح پر توثیق اور نیوی گیشن میں بہتری

نیا نصاب مواد شامل کیا گیا

ماڈیول 03 - شروعات

12-mcp-hosts/README.md: MCP ہوسٹس سیٹ اپ کے لیے نئی جامع رہنما کتاب
- کلاؤڈ ڈیسک ٹاپ، VS کوڈ، کرسر، کلائن، ونڈسرف کنفیگریشن کی مثالیں
- تمام اہم ہوسٹس کے لیے JSON کنفیگریشن ٹیمپلیٹس
- ٹرانسپورٹ اقسام کا موازنہ جدول (stdio، SSE/HTTP، WebSocket)
- عام کنکشن مسائل کا حل
- ہوسٹ کنفیگریشن کے لیے سیکیورٹی کی بہترین مشقیں
13-mcp-inspector/README.md: MCP انسپیکٹر کے لیے نیا ڈیبگنگ گائیڈ
- انسٹالیشن کے طریقے (npx، npm عالمی، سورس سے)
- stdio اور HTTP/SSE کے ذریعے سرور سے کنکشن
- ٹولز، وسائل، اور پرامپٹ ورک فلو کا ٹیسٹ کرنا
- MCP انسپیکٹر کے ساتھ VS کوڈ انضمام
- عام ڈیبگنگ حالات اور ان کے حل

ماڈیول 04 - عملی نفاذ

pagination/README.md: نئی پیجینیشن عمل درآمد گائیڈ
- پائتھون، ٹائپ اسکرپٹ، جاوا میں کرسر بیسڈ پیجینیشن کے پیٹرنز
- کلائنٹ سائڈ پیجینیشن ہینڈلنگ
- کرسر ڈیزائن کی حکمت عملی (opaque بمقابلہ structured)
- کارکردگی کی بہتری کے مشورے

ماڈیول 05 - اعلیٰ موضوعات

mcp-protocol-features/README.md: نئے پروٹوکول فیچرز کی گہرائی میں جانچ
- پروگریس نوٹیفیکیشنز کا نفاذ
- ریکویسٹ کینسلیشن پیٹرنز
- URI پیٹرنز کے ساتھ ریسورس ٹیمپلیٹس
- سرور کی زندگی کا انتظام
- لاگنگ لیول کنٹرول
- JSON-RPC کوڈز کے ساتھ ایرر ہینڈلنگ پیٹرنز

نیوی گیشن کی اصلاحات (24+ فائلیں اپ ڈیٹ ہوئیں)

مین ماڈیول ریڈمیز
اب یہ پہلی سبق اور اگلے ماڈیول دونوں کو لنک کرتے ہیں

02-Security ذیلی فائلیں
تمام 5 اضافی سیکیورٹی دستاویزات میں اب "اگلا کیا ہے" نیوی گیشن شامل ہے:

09-CaseStudy فائلیں
تمام کیس اسٹڈی فائلوں میں اب تسلسل کے ساتھ نیوی گیشن موجود ہے:

10-StreamliningAI لیبز
ماڈیول 10 کے جائزے اور ماڈیول 11 میں "اگلا کیا ہے" سیکشن شامل کیا گیا

کوڈ اور مواد کی اصلاحات

SDK اور انحصار کی تازہ کاری
خالی openai ورژن کو ^4.95.0 پر درست کیا گیا
SDK کو ^1.8.0 سے >=1.26.0 تک اپ ڈیٹ کیا گیا
mcp ورژن پنز کو >=1.26.0 پر اپ ڈیٹ کیا گیا

کوڈ اصلاحات
غلط ماڈل gpt-4o-mini کو gpt-4.1-mini میں درست کیا گیا

مواد کی اصلاحات
ٹوٹے ہوئے لنک READMEmd کو README.md میں درست کیا گیا، نصاب کے ہیڈر Module 1-3 کو Module 0-3 میں درست کیا گیا، کیس حساس راستے کی اصلاح کی گئی
خراب شدہ ڈپلیکٹ کیس اسٹڈی 5 کا مواد ہٹا دیا گیا

ابتدائی راہنمائي میں بہتری
نو آموزوں کے لیے مناسب تعارف، تعلیمی مقاصد، اور ضروریات شامل کی گئی

نصاب کی تازہ کاری

مین README.md
نصاب جدول میں انٹریز 3.12 (MCP Hosts)، 3.13 (MCP Inspector)، 4.1 (Pagination)، 5.16 (Protocol Features) شامل کی گئیں

ماڈیول ریڈمیز
سبقوں کی فہرست میں 12 اور 13 شامل کیے گئے
پریکٹیکل گائیڈز سیکشن میں پیجینیشن کا لنک شامل کیا گیا
سبقوں 5.15 (Custom Transport) اور 5.16 (Protocol Features) شامل کیے گئے

study_guide.md
نئے تمام موضوعات کے ساتھ مائنڈ میپ اپ ڈیٹ کیا گیا: MCP ہوسٹس سیٹ اپ، MCP انسپیکٹر، پیجینیشن حکمت عملی، پروٹوکول فیچرز کی گہرائی

28 جنوری، 2026

MCP وضاحت 2025-11-25 کی تعمیل کا جائزہ

بنیادی تصورات میں بہتری (01-CoreConcepts/)

نیا کلائنٹ پرامیٹو — Roots: Roots کلائنٹ پرامیٹو کی جامع دستاویز شامل کی گئی، جو سرورز کو فائل سسٹم کی حدود اور رسائی کی اجازتیں سمجھنے کے قابل بناتی ہے
ٹول تشریحات: ٹول کے رویے کی تشریحات (readOnlyHint, destructiveHint) پر دستاویز شامل کی گئیں تاکہ ٹول کے چلانے کے فیصلے بہتر ہوں
Sampling میں ٹول کالنگ: سیمپلنگ دستاویز کو اپ ڈیٹ کیا گیا تاکہ tools اور toolChoice پیرامیٹرز ماڈل کی جانب سے ٹول کال کرنے کے لیے شامل ہوں
URL موڈ ایلیسیٹیشن: سرور کی جانب سے شروع کیے گئے بیرونی ویب انٹریکشنز کے لیے URL پر مبنی ایلیسیٹیشن کی دستاویز شامل کی گئی
ٹاسکس (تجرباتی): تجرباتی ٹاسکس فیچر کے لیے نئی سیکشن شامل کی گئی جو پائیدار ایکزیکیوشن ریپرز اور مؤخر الذکر نتیجہ نکالنے کے بارے میں ہے
آئیکنز کی حمایت: نوٹ کیا گیا کہ ٹولز، وسائل، ریسورس ٹیمپلیٹس اور پرامپٹس اب اضافی میٹا ڈیٹا کے طور پر آئیکنز شامل کر سکتے ہیں

دستاویزات کی تازہ کاری

README.md: MCP وضاحت 2025-11-25 ورژن ریفرنس اور تاریخ کی بنیاد پر ورژننگ کی وضاحت شامل کی گئی
study_guide.md: نصاب کا نقشہ اپ ڈیٹ کیا گیا تاکہ ٹاسکس اور ٹول تشریحات کو بنیادی تصورات میں شامل کیا جا سکے؛ دستاویز کا ٹائم اسٹیمپ اپ ڈیٹ کیا گیا

وضاحت کی تعمیل کی تصدیق

پروٹوکول ورژن: تمام دستاویزات نے موجودہ MCP وضاحت 2025-11-25 کی تصدیق کی
آرکیٹیکچرل ہم آہنگی: دو پرت والی آرکیٹیکچر (ڈیٹا پرت + ٹرانسپورٹ پرت) کی دستاویز کی درستگی کی تصدیق کی گئی
پرا میٹو کی دستاویزات: سرور پرا میٹوز (Resources, Prompts, Tools) اور کلائنٹ پرا میٹوز (Sampling, Elicitation, Logging, Roots) کی تصدیق کی گئی
ٹرانسپورٹ میکانزم: STDIO اور Streamable HTTP ٹرانسپورٹ کی دستاویزات کی درستگی کی تصدیق کی گئی
سیکیورٹی رہنمائی: موجودہ MCP سیکیورٹی بہترین عملی دستاویزات کے مطابق ہونے کی تصدیق کی گئی

MCP 2025-11-25 کے کلیدی فیچرز دستاویز کیے گئے

OpenID Connect دریافت: OIDC کے ذریعے آتھنٹیکیشن سرور کی دریافت
OAuth کلائنٹ ID میٹا ڈیٹا دستاویزات: سفارش شدہ کلائنٹ رجسٹریشن میکانزم
JSON Schema 2020-12: MCP اسکیمہ تعریف کے لیے ڈیفالٹ ڈائلیکٹ
SDK کی سطح بندی کا نظام: SDK فیچر سپورٹ اور دیکھ بھال کے لیے باقاعدہ ضروریات
گورننس ساخت: MCP گورننس میں ورکنگ گروپس اور انٹرسٹ گروپس کی باقاعدہ منظوری

سیکیورٹی دستاویزات کی بڑی تازہ کاری (02-Security/)

MCP سیکیورٹی سمٹ ورکشاپ (Sherpa) انضمام

نیا ہینڈس آن ٹریننگ وسائل: MCP Security Summit Workshop (Sherpa) کے ساتھ تمام سیکیورٹی دستاویزات میں جامع انضمام شامل کیا گیا
مہم کی راہ کا احاطہ: بیس کیمپ سے سمٹ تک کیمپ سے کیمپ مکمل پیش رفت کو دستاویزی شکل دی گئی
OWASP مطابقت: تمام سیکیورٹی رہنمائی اب OWASP MCP Azure سیکیورٹی گائیڈ خطرات کے مطابق ہے

OWASP MCP ٹاپ 10 انضمام

نیا سیکشن: مین سیکیورٹی README میں OWASP MCP ٹاپ 10 سیکیورٹی خطرات اور Azure کے تخفیفات کا جدول شامل کیا گیا
خطرے کی بنیاد پر دستاویزات: mcp-security-controls-2025.md کو اپنے ہر سیکیورٹی ڈومین کے لیے OWASP MCP خطرہ حوالے کے ساتھ اپ ڈیٹ کیا گیا
حوالہ آرکیٹیکچر: OWASP MCP Azure سیکیورٹی گائیڈ کے حوالے اور نفاذ پیٹرنز کے لنکس شامل کیے گئے

اپ ڈیٹ کی گئی سیکیورٹی فائلیں

README.md: Sherpa ورکشاپ کا جائزہ، مہم کی راہ کا جدول، OWASP MCP ٹاپ 10 خطرات کا خلاصہ، اور ہینڈس آن ٹریننگ سیکشن شامل کیا گیا
mcp-security-controls-2025.md: ہیڈر کو فروری 2026 میں اپ ڈیٹ کیا گیا، OWASP خطرے کے حوالے (MCP01-MCP08) شامل کیے گئے، اور سپیک ورژن کی غیر مطابقت درست کی گئی
mcp-security-best-practices-2025.md: Sherpa اور OWASP وسائل کا سیکشن شامل کیا گیا، ٹائم اسٹیمپ اپ ڈیٹ کیا گیا
mcp-best-practices.md: ہینڈس آن ٹریننگ سیکشن Sherpa اور OWASP لنکس کے ساتھ شامل کیا گیا
azure-content-safety-implementation.md: OWASP MCP06 حوالہ، Sherpa کیمپ 3 مطابقت، اور اضافی وسائل شامل کیے گئے

نئے وسائل کے لنکس شامل کیے گئے

MCP Security Summit Workshop (Sherpa)
OWASP MCP Azure Security Guide
OWASP MCP Top 10
OWASP MCP کے انفرادی خطرے والے صفحات (MCP01-MCP10)

نصاب میں MCP وضاحت 2025-11-25 کی ہم آہنگی

ماڈیول 03 - شروعات

SDK دستاویزات: Go SDK کو سرکاری SDK فہرست میں شامل کیا گیا؛ MCP وضاحت 2025-11-25 کے مطابق تمام SDK حوالہ جات کو اپ ڈیٹ کیا گیا
ٹرانسپورٹ وضاحت: STDIO اور HTTP اسٹریمنگ ٹرانسپورٹ کی وضاحتیں واضح طور پر سپیک کے حوالے کے ساتھ اپ ڈیٹ کی گئیں

ماڈیول 04 - عملی نفاذ

SDK تازہ کاری: Go SDK شامل کیا گیا؛ SDK فہرست کو اسپیسفکیشن ورژن کے حوالے سے اپ ڈیٹ کیا گیا
اتھارائزیشن وضاحت: MCP اتھارائزیشن اسپیک کا لنک موجودہ 2025-11-25 ورژن پر اپ ڈیٹ کیا گیا

ماڈیول 05 - اعلیٰ موضوعات

نئی خصوصیات: MCP وضاحت 2025-11-25 کی نئی خصوصیات (ٹاسکس، ٹول تشریحات، URL موڈ ایلیسیٹیشن، Roots) کے بارے میں نوٹ شامل کیا گیا
سیکیورٹی وسائل: اضافی حوالہ جات میں OWASP MCP ٹاپ 10 اور Sherpa ورکشاپ کے لنکس شامل کیے گئے

ماڈیول 06 - کمیونٹی تعاون

SDK فہرست: Swift اور Rust SDKs شامل کیے گئے؛ سپیک لنک کو 2025-11-25 پر اپ ڈیٹ کیا گیا
سپیک حوالہ: MCP وضاحت کا لنک براہ راست سپیک لنک پر اپ ڈیٹ کیا گیا

ماڈیول 07 - ابتدائی اپنانے سے سبق

وسائل کی تازہ کاری: MCP وضاحت 2025-11-25 کے لنک اور OWASP MCP ٹاپ 10 کو اضافی وسائل میں شامل کیا گیا

ماڈیول 08 - بہترین طریقے

سپیک ورژن: MCP وضاحت حوالہ کو 2025-11-25 پر اپ ڈیٹ کیا گیا
سیکیورٹی وسائل: اضافی وسائل میں OWASP MCP ٹاپ 10 اور Sherpa ورکشاپ شامل کردی گئی

ماڈیول 10 - AI ورک فلو کو بہتر بنانا

بیج اپ ڈیٹ: MCP ورژن بیج کو SDK ورژن (1.9.3) سے وضاحت ورژن (2025-11-25) میں تبدیل کیا گیا
وسیلوں کے لنکس: MCP وضاحت کا لنک اپ ڈیٹ کیا گیا؛ OWASP MCP ٹاپ 10 شامل کیا گیا

ماڈیول 11 - MCP سرور ہینڈز آن لیبز

سپیک حوالہ: MCP وضاحت لنک کو 2025-11-25 ورژن پر اپ ڈیٹ کیا گیا
سیکیورٹی وسائل: سرکاری وسائل میں OWASP MCP ٹاپ 10 شامل کیا گیا

18 دسمبر، 2025

سیکیورٹی دستاویزات کی تازہ کاری - MCP وضاحت 2025-11-25

MCP سیکیورٹی بہترین عمل (02-Security/mcp-best-practices.md) - سپیک ورژن اپ ڈیٹ

پروٹوکول ورژن اپ ڈیٹ: تازہ ترین MCP وضاحت 2025-11-25 (25 نومبر 2025 کو جاری) کے حوالے شامل کیے گئے
- تمام سپیک ورژن حوالہ جات کو 2025-06-18 سے 2025-11-25 پر اپ ڈیٹ کیا گیا
- دستاویز کی تاریخ کو 18 اگست 2025 سے 18 دسمبر 2025 میں تبدیل کیا گیا
- تمام سپیک URLs کو موجودہ دستاویزات کی طرف درست کیا گیا
مواد کی توثیق: سیکیورٹی بہترین عمل کی مکمل جانچ تازہ ترین معیارات کے مطابق کی گئی
- مائیکروسافٹ سیکیورٹی حل: موجودہ اصطلاحات اور لنکس کی تصدیق کی گئی جیسے Prompt Shields (پہلے "Jailbreak risk detection" کہا جاتا تھا)، Azure Content Safety، Microsoft Entra ID، اور Azure Key Vault
- OAuth 2.1 سیکیورٹی: تازہ ترین OAuth سیکیورٹی بہترین عمل کے مطابق ہونے کی تصدیق کی گئی
- OWASP معیارات: LLMs کے لیے OWASP ٹاپ 10 حوالہ جات کو موجودہ حالت میں برقرار رکھا گیا
- Azure سروسز: تمام Microsoft Azure دستاویزات کے لنکس اور بہترین عمل کی تصدیق کی گئی
معیارات کے مطابق ہونا: تمام حوالہ دی گئی سیکیورٹی معیارات کو موجودہ حالت میں برقرار رکھا گیا
- NIST AI رِسک مینجمنٹ فریم ورک
- ISO 27001:2022
- OAuth 2.1 سیکیورٹی بہترین عمل
- Azure سیکیورٹی اور تعمیل کے فریم ورک
نفاذ کے وسائل: تمام نفاذ گائیڈز کے لنکس اور وسائل کی توثیق کی گئی
- Azure API مینجمنٹ آتھنٹیکیشن پیٹرنز
- Microsoft Entra ID انضمام گائیڈز
- Azure Key Vault سیکرٹس مینجمنٹ
- DevSecOps پائپ لائنز اور مانیٹرنگ حل

دستاویزات کے معیار کی یقین دہانی

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

6 اکتوبر، 2025

شروعات سیکشن میں توسیع – جدید سرور کے استعمال اور سادہ آتھنٹیکیشن

جدید سرور کا استعمال (03-GettingStarted/10-advanced)

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

سادہ تصدیق (03-GettingStarted/11-simple-auth)

نیا باب شامل: MCP سرورز میں سادہ تصدیق نافذ کرنے کے لیے مرحلہ وار رہنما۔
- تصدیق کے تصورات: تصدیق بمقابلہ اجازت کی واضح وضاحت، اور اسناد کی ہینڈلنگ۔
- بنیادی تصدیق نفاذ: پائتھن (Starlette) اور ٹائپ اسکرپٹ (Express) میں مڈل ویئر پر مبنی تصدیقی پیٹرنز، کوڈ نمونوں کے ساتھ۔
- جدید سیکیورٹی کی طرف ترقی: سادہ تصدیق سے شروع کرنے اور OAuth 2.1 اور RBAC تک ترقی کرنے کی رہنمائی، جدید سیکیورٹی ماڈیولز کے حوالے کے ساتھ۔

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

29 ستمبر، 2025

MCP سرور ڈیٹا بیس انٹیگریشن لیبز - جامع ہینڈز آن لرننگ پاتھ

11-MCPServerHandsOnLabs - نیا مکمل ڈیٹا بیس انٹیگریشن نصاب

مکمل 13 لیب لرننگ پاتھ: پوسٹ گری ایس کیو ایل ڈیٹا بیس انٹیگریشن کے ساتھ پروڈکشن ریڈی MCP سرورز بنانے کے لیے جامع ہینڈز آن نصاب شامل کیا گیا
- حقیقی دنیا کا نفاذ: انٹرپرائز گریڈ پیٹرنز کے مظاہرے کے لیے Zava Retail اینالیٹکس کیس
- منظم لرننگ ترقی:
  - لیبز 00-03: بنیادیں - تعارف، بنیادی آرکیٹیکچر، سیکیورٹی اور ملٹی ٹیننسی، ماحول کی تیاری
  - لیبز 04-06: MCP سرور بنانا - ڈیٹا بیس ڈیزائن اور اسکیما، MCP سرور کا نفاذ، ٹول ڈیولپمنٹ
  - لیبز 07-09: جدید فیچرز - سیمانٹک سرچ انٹیگریشن، ٹیسٹنگ اور ڈیبگنگ، وی ایس کوڈ انٹیگریشن
  - لیبز 10-12: پروڈکشن اور بہترین طریقے - تعیناتی کی حکمت عملی، مانیٹرنگ اور آبزرویبیلٹی، بہترین طریقے اور اصلاح
- انٹرپرائز ٹیکنالوجیز: FastMCP فریم ورک، پوسٹ گری ایس کیو ایل بذریعہ pgvector، Azure OpenAI embeddings، Azure Container Apps، Application Insights
- جدید فیچرز: رو لیول سیکیورٹی (RLS)، سیمانٹک سرچ، ملٹی ٹیننٹ ڈیٹا تک رسائی، ویکٹر embeddings، ریئل ٹائم مانیٹرنگ

اصطلاحات کی معیاری کاری - ماڈیول سے لیب تبدیلی

جامع دستاویزی اپڈیٹ: 11-MCPServerHandsOnLabs کی تمام README فائلز کو "ماڈیول" کی بجائے "لیب" اصطلاح کے استعمال کے لیے منظم انداز میں اپڈیٹ کیا گیا
- سیکشن ہیڈرز: تمام 13 لیبز میں "What This Module Covers" کو "What This Lab Covers" میں تبدیل کیا گیا
- مواد کی وضاحت: ڈاکیومنٹیشن میں تمام جگہ "This module provides..." کو "This lab provides..." میں تبدیل کیا گیا
- لرننگ آبجیکٹیوز: "By the end of this module..." کو "By the end of this lab..." میں اپڈیٹ کیا گیا
- نیویگیشن لنکس: تمام "Module XX:" حوالہ جات کو "Lab XX:" میں تبدیل کیا گیا
- کیمپلیشن ٹریکنگ: "After completing this module..." کو "After completing this lab..." میں اپڈیٹ کیا گیا
- ٹیکنیکل حوالہ جات برقرار: کنفیگریشن فائلز میں پائتھن ماڈیول حوالہ جات (مثلاً "module": "mcp_server.main") کو برقرار رکھا گیا

سٹڈی گائیڈ کی بہتری (study_guide.md)

بصری نصاب کا نقشہ: نئے "11. Database Integration Labs" سیکشن کے ساتھ جامع لیب اسٹرکچر کا ویژولائزیشن شامل کی گئی
ریزپوزیٹری اسٹرکچر: دس سے گیارہ مرکزی سیکشنز تک اپڈیٹ ہوا، تفصیلی 11-MCPServerHandsOnLabs کی وضاحت کے ساتھ
لرننگ پاتھ ہدایت: 00-11 سیکشنز کے لیے نیویگیشن ہدایات کو بہتر بنایا گیا
ٹیکنالوجی کا احاطہ: FastMCP، پوسٹ گری ایس کیو ایل، Azure خدمات کی انٹیگریشن کی تفصیلات شامل کیں
لرننگ کے نتائج: پروڈکشن ریڈی سرور ڈیولپمنٹ، ڈیٹا بیس انٹیگریشن پیٹرنز، اور انٹرپرائز سیکیورٹی پر زور دیا گیا

مرکزی README اسٹرکچر کی بہتری

لیب پر مبنی اصطلاحات: 11-MCPServerHandsOnLabs میں مرکزی README.md کو مستقل طور پر "Lab" اسٹرکچر استعمال کرنے کے لیے اپڈیٹ کیا گیا
لرننگ پاتھ آرگنائزیشن: بنیادی تصورات سے لے کر جدید نفاذ اور پروڈکشن تعیناتی تک واضح ترقی
حقیقی دنیا پر توجہ: عملی، ہینڈز آن لرننگ کے ذریعے انٹرپرائز گریڈ پیٹرنز اور ٹیکنالوجیز پر زور

دستاویزات کی معیار اور مستقل مزاجی میں بہتری

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

26 ستمبر، 2025

کیس اسٹڈیز کی بہتری - GitHub MCP رجسٹری انٹیگریشن

کیس اسٹڈیز (09-CaseStudy/) - ایکو سسٹم ترقی پر توجہ

README.md: GitHub MCP رجسٹری کیس اسٹڈی کے ساتھ بڑے پیمانے پر توسیع
- GitHub MCP رجسٹری کیس اسٹڈی: ستمبر 2025 میں GitHub کے MCP رجسٹری لانچ کا جامع تجزیہ
  - مسئلہ کا تجزیہ: MCP سرور کی دریافت اور تعیناتی میں ٹوٹ پھوٹ کے چیلنجز کی تفصیلی جانچ
  - حل کی آرکیٹیکچر: GitHub کا مرکزی رجسٹری نقطہ نظر، ایک کلک VS Code انسٹالیشن کے ساتھ
  - کاروباری اثرات: ڈویلپر آن بورڈنگ اور پیداواری صلاحیت میں قابل پیمائش بہتری
  - حکمت عملی کی قدر: ماڈیولر ایجنٹ تعیناتی اور کراس ٹول انٹرآپریبیلٹی پر توجہ
  - ایکو سسٹم کی ترقی: ایجنٹک انٹیگریشن کے لیے بنیادی پلیٹ فارم کے طور پر پوزیشننگ
- کیس اسٹڈی اسٹرکچر کی بہتری: ساتوں کیس اسٹڈیز کو مستقل فارمیٹنگ اور جامع تفصیلات کے ساتھ اپ ڈیٹ کیا گیا
  - Azure AI ٹریول ایجنٹس: ملٹی ایجنٹ آرکیسٹریشن پر زور
  - Azure DevOps انٹیگریشن: ورک فلو آٹومیشن پر توجہ
  - ریئل ٹائم ڈاکیومنٹیشن بازیافت: پائتھن کنسول کلائنٹ نفاذ
  - انٹرایکٹو سٹڈی پلان جنریٹر: Chainlit کانورسیشنل ویب ایپ
  - ایڈیٹر میں ڈاکیومنٹیشن: VS Code اور GitHub Copilot انٹیگریشن
  - Azure API مینجمنٹ: انٹرپرائز API انٹیگریشن پیٹرنز
  - GitHub MCP رجسٹری: ایکو سسٹم ترقی اور کمیونٹی پلیٹ فارم
- جامع نتیجہ: سات کیس اسٹڈیز کا تفصیلی خلاصہ جو متعدد MCP نفاذ جہتوں کا احاطہ کرتا ہے
  - انٹرپرائز انٹیگریشن، ملٹی-ایجنٹ آرکیسٹریشن، ڈویلپر پیداواری صلاحیت
  - ایکو سسٹم کی ترقی، تعلیمی ایپلیکیشنز کی درجہ بندی
  - آرکیٹیکچرل پیٹرنز، نفاذ کی حکمت عملیوں، اور بہترین طریقوں پر گہرائی سے بصیرت
  - MCP کو بالغ، پروڈکشن ریڈی پروٹوکول کے طور پر اجاگر کرنا

سٹڈی گائیڈ اپڈیٹس (study_guide.md)

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

دستاویزات کے معیار کی بہتری

مستقل مزاجی کی بہتری: ساتوں مثالوں میں کیس اسٹڈی کی فارمیٹنگ اور اسٹرکچر کو معیاری بنایا گیا
جامع احاطہ: کیس اسٹڈیز اب انٹرپرائز، ڈویلپر پیداواری، اور ایکو سسٹم ترقی کے منظرناموں کا احاطہ کرتی ہیں
حکمت عملی کی پوزیشننگ: MCP کو ایجنٹک سسٹم تعیناتی کے لیے بنیادی پلیٹ فارم کے طور پر مضبوط توجہ
وسائل انٹیگریشن: اضافی وسائل میں GitHub MCP رجسٹری لنک کو اپڈیٹ کیا گیا

15 ستمبر، 2025

جدید موضوعات کی توسیع - کسٹم ٹرانسپورٹس اور کانٹیکسٹ انجینئرنگ

MCP کسٹم ٹرانسپورٹس (05-AdvancedTopics/mcp-transport/) - نیا جدید نفاذ گائیڈ

README.md: کسٹم MCP ٹرانسپورٹ میکانزم کے لیے مکمل نفاذ گائیڈ
- Azure Event Grid ٹرانسپورٹ: سرور لیس ایونٹ ڈرائیون ٹرانسپورٹ کا جامع نفاذ
  - C#، ٹائپ اسکرپٹ، اور پائتھن کی مثالیں Azure Functions انٹیگریشن کے ساتھ
  - اسکیل ایبل MCP سولیوشنز کے لیے ایونٹ ڈرائیون آرکیٹیکچر پیٹرنز
  - ویب ہُک رسیورز اور پوش بیسڈ میسج ہینڈلنگ
- Azure Event Hubs ٹرانسپورٹ: ہائی تھرو پٹ اسٹریمنگ ٹرانسپورٹ نفاذ
  - کم تاخیر والے منظرناموں کے لیے ریئل ٹائم اسٹریمنگ صلاحیتیں
  - پارٹیشننگ حکمت عملی اور چیک پوائنٹ مینجمنٹ
  - میسج بیچنگ اور کارکردگی کی اصلاح
- انٹرپرائز انٹیگریشن پیٹرنز: پروڈکشن ریڈی آرکیٹیکچرل مثالیں
  - متعدد Azure Functions میں تقسیم شدہ MCP پراسیسنگ
  - مختلف ٹرانسپورٹ اقسام کو ملا کر ہائبرڈ ٹرانسپورٹ آرکیٹیکچرز
  - میسج ڈوریبیلٹی، اعتماد، اور ایرر ہینڈلنگ حکمت عملی
- سیکیورٹی اور مانیٹرنگ: Azure Key Vault انٹیگریشن اور آبزرویبیلٹی پیٹرنز
  - مینیجڈ شناختی تصدیق اور کم سے کم مراعات رسائی
  - Application Insights ٹیلی میٹری اور کارکردگی کی مانیٹرنگ
  - سرکٹ بریکرز اور فالٹ ٹالرنس پیٹرنز
- ٹیسٹنگ فریم ورکس: کسٹم ٹرانسپورٹس کے لیے جامع ٹیسٹنگ حکمت عملی
  - یونٹ ٹیسٹنگ بذریعہ ٹیسٹ ڈبلز اور ماکنگ فریم ورکس
  - Azure Test Containers کے ساتھ انٹیگریشن ٹیسٹنگ
  - کارکردگی اور لوڈ ٹیسٹنگ کے تقاضے

کانٹیکسٹ انجینئرنگ (05-AdvancedTopics/mcp-contextengineering/) - ابھرتا ہوا AI شعبہ

README.md: کانٹیکسٹ انجینئرنگ کے ابھرتے ہوئے میدان کی جامع تلاش
- بنیادی اصول: مکمل کانٹیکسٹ شیئرنگ، ایکشن فیصلے کی آگاہی، اور کانٹیکسٹ ونڈو مینجمنٹ
- MCP پروٹوکول مطابقت: MCP ڈیزائن کیسے کانٹیکسٹ انجینئرنگ کے چیلنجز کو حل کرتا ہے
  - کانٹیکسٹ ونڈو کی حدود اور تدریجی لوڈنگ حکمت عملی
  - موزونیت کا تعین اور متحرک کانٹیکسٹ بازیافت
  - کثیر الوضعی کانٹیکسٹ ہینڈلنگ اور سیکیورٹی کے پہلو
- نفاذ کے طریقے: سنگل تھریڈ بمقابلہ ملٹی-ایجنٹ آرکیٹیکچرز
  - کانٹیکسٹ چنکنگ اور ترجیحی تکنیکیں
  - تدریجی کانٹیکسٹ لوڈنگ اور کمپریشن حکمت عملی
  - پرت دار کانٹیکسٹ اپروچز اور بازیافت کی اصلاح
- ماپنے کا فریم ورک: کانٹیکسٹ کی مؤثریت کے لیے ابھرتے ہوئے میٹرکس
  - ان پٹ ایفیشنسی، کارکردگی، معیار، اور صارف کے تجربے کے نکات
  - کانٹیکسٹ آپٹیمائزیشن کے تجرباتی طریقے
  - ناکامی کا تجزیہ اور بہتری کے طریقہ کار

نصاب نیویگیشن اپڈیٹس (README.md)

پیچیدہ ماڈیول اسٹرکچر: نئے جدید موضوعات شامل کرنے کے لیے نصاب کی میز اپڈیٹ کی گئی
- کانٹیکسٹ انجینئرنگ (5.14) اور کسٹم ٹرانسپورٹ (5.15) اندراجات شامل کی گئیں
- تمام ماڈیولز میں مستقل فارمیٹنگ اور نیویگیشن لنکس
- موجودہ مواد کے دائرہ کار کی عکاسی کرنے کے لیے وضاحتیں اپڈیٹ کی گئیں

ڈائریکٹری اسٹرکچر کی بہتری

ناموں کی معیاری کاری: "mcp transport" کو "mcp-transport" میں تبدیل کیا گیا تاکہ دیگر جدید موضوعات کے فولڈرز کے تعمیل میں رہے
مواد کی تنظیم: تمام 05-AdvancedTopics فولڈرز اب مستقل ناموں کے پیٹرن (mcp-[topic]) پر عمل کرتے ہیں

دستاویزات کی معیار کی بہتریاں

MCP وضاحت کی مطابقت: تمام نئے مواد کو موجودہ MCP Specification 2025-06-18 کے حوالے سے بنایا گیا
کثیر زبان کی مثالیں: C#، ٹائپ اسکرپٹ، اور پائتھن میں جامع کوڈ کی مثالیں
انٹرپرائز توجہ: پروڈکشن ریڈی پیٹرنز اور Azure کلاؤڈ انٹیگریشن ساری دستاویز میں شامل
بصری دستاویزات: آرکیٹیکچر اور فلو ویژولائزیشن کے لیے Mermaid ڈایاگرامز

18 اگست، 2025

دستاویزات کی جامع اپڈیٹ - MCP 2025-06-18 معیارات

MCP سیکیورٹی بہترین طریقے (02-Security/) - مکمل جدید کاری

MCP-SECURITY-BEST-PRACTICES-2025.md: MCP Specification 2025-06-18 کے مطابق مکمل ازسرنو تحریر
- لازمی تقاضے: سرکاری وضاحت سے MUST/MUST NOT تقاضوں کے واضح بصری اشارے کے ساتھ اضافہ
- 12 بنیادی سیکیورٹی طریقے: 15 آئٹمز کی فہرست سے جامع سیکیورٹی شعبے میں ترتیب
  - ٹوکن سیکیورٹی اور تصدیق بذریعہ بیرونی شناختی فراہم کنندہ انٹیگریشن
  - سیشن مینجمنٹ اور ٹرانسپورٹ سیکیورٹی بذریعہ کرپٹوگرافک تقاضے
  - AI مخصوص خطرہ تحفظ کے لیے Microsoft Prompt Shields انٹیگریشن
  - رسائی کنٹرول اور اجازتیں، کم سے کم مراعات کا اصول
  - مواد کی حفاظت اور نگرانی کے لیے Azure Content Safety انٹیگریشن
  - سپلائی چین سیکیورٹی بموجب جامع اجزاء کی تصدیق
  - OAuth سیکیورٹی اور Confused Deputy کی روک تھام، PKCE نفاذ کے ساتھ
  - واقعہ جواب اور بحالی، خودکار صلاحیتوں کے ساتھ
  - تعمیل اور حکمرانی، ضوابط سے ہم آہنگی
  - جدید سیکیورٹی کنٹرولز، صفر اعتماد آرکیٹیکچر
  - Microsoft سیکیورٹی ایکو سسٹم انٹیگریشن، جامع حل کے ساتھ
  - مسلسل سیکیورٹی کی ترقی، مطابقت پذیر طریقے
- Microsoft سیکیورٹی حل: Prompt Shields، Azure Content Safety، Entra ID، اور GitHub Advanced Security کے جامع انٹیگریشن رہنمائی
- نفاذ کے وسائل: سرکاری MCP دستاویزات، Microsoft سیکیورٹی حل، سیکیورٹی معیارات، اور رہنما خطوط کے ذریعے جامع وسائل کے روابط کی درجہ بندی

جدید سیکیورٹی کنٹرولز (02-Security/) - انٹرپرائز نفاذ

MCP-SECURITY-CONTROLS-2025.md: انٹرپرائز گریڈ سیکیورٹی فریم ورک کے ساتھ مکمل تبدیلی
- 9 جامع سیکیورٹی شعبے: بنیادی کنٹرولز سے تفصیلی انٹرپرائز فریم ورک میں توسیع
  - Microsoft Entra ID انٹیگریشن کے ساتھ جدید تصدیق اور اجازت
  - ٹوکن سیکیورٹی اور اینٹی پاس تھرو کنٹرولز کے ساتھ جامع اعتبار
  - سیشن سیکیورٹی کنٹرولز، ہائی جیکنگ کی روک تھام
  - AI مخصوص سیکیورٹی کنٹرولز، پرامپٹ انجیکشن اور ٹول زہریلاپن کی روک تھام
  - Confused Deputy حملہ کی روک تھام، OAuth پراکسی سیکیورٹی
  - ٹول ایگزیکیوشن سیکیورٹی کے ساتھ سینڈباکسنگ اور الگ تھلگ رکھنا
  - سپلائی چین سیکیورٹی کنٹرولز، انحصار کی تصدیق
  - مانیٹرنگ اور ڈیٹیکشن کنٹرولز، SIEM انٹیگریشن
  - واقعہ جواب اور بحالی، خودکار صلاحیتوں کے ساتھ
- نفاذ کی مثالیں: تفصیلی YAML کنفیگریشن بلاکس اور کوڈ کی مثالوں کا اضافہ
- Microsoft حل انٹیگریشن: Azure سیکیورٹی خدمات، GitHub Advanced Security، اور انٹرپرائز شناختی مینجمنٹ کا جامع احاطہ

جدید موضوعات سیکیورٹی (05-AdvancedTopics/mcp-security/) - پروڈکشن ریڈی نفاذ

README.md: انٹرپرائز سیکیورٹی نفاذ کے لیے مکمل ازسرنو تحریر
- موجودہ وضاحت کے مطابق: MCP Specification 2025-06-18 کے مطابق تازہ کاری، لازمی سیکیورٹی تقاضوں کے ساتھ
- جدید تصدیق: Microsoft Entra ID انٹیگریشن، جامع .NET اور Java Spring Security مثالوں کے ساتھ
- AI سیکیورٹی انٹیگریشن: Microsoft Prompt Shields اور Azure Content Safety نفاذ، تفصیلی پائتھن مثالوں کے ساتھ
- جدید خطرہ تخفیف:
  - PKCE اور صارف کی رضامندی کی جانچ کے ساتھ Confused Deputy حملے کی روک تھام کے جامع نفاذ کی مثالیں
  - آڈینس کی توثیق اور محفوظ ٹوکن مینجمنٹ کے ساتھ ٹوکن پاس تھرو کی روک تھام
  - سیشن ہائی جیکنگ کی روک تھام کے لیے کرپٹوگرافک بائنڈنگ اور رویتی تجزیہ
- انٹرپرائز سیکیورٹی انٹیگریشن: ایژر ایپلیکیشن انسائٹس مانیٹرنگ، تھریٹ ڈٹیکشن پائپ لائنس، اور سپلائی چین سیکیورٹی
- نفاذ چیک لسٹ: واضح لازمی بمقابلہ تجویز کردہ سیکیورٹی کنٹرولز کے ساتھ مائیکروسافٹ سیکیورٹی ایکو سسٹم کے فوائد

دستاویزات کی کوالٹی اور معیارات کے ہم آہنگی

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

بنیادی تصورات (01-CoreConcepts/) - مکمل جدید کاری

پروٹوکول ورژن اپڈیٹ: موجودہ MCP تخصیص 2025-06-18 کی تاریخ کی بنیاد پر ورژننگ (YYYY-MM-DD فارمیٹ) کے ساتھ حوالہ جات اپ ڈیٹ کیے گئے
معماری کی باریکی: میزبانوں، کلائنٹس، اور سرورز کی وضاحت کو موجودہ MCP آرکیٹیکچر پیٹرنز کے مطابق بہتر بنایا گیا
- میزبان اب واضح طور پر AI ایپلیکیشنز کے طور پر تعریف کیے گئے ہیں جو متعدد MCP کلائنٹ کنکشنز کو مربوط کرتے ہیں
- کلائنٹس کو پروٹوکول کنیکٹرز کے طور پر بیان کیا گیا ہے جو سرور کے ساتھ ایک سے ایک تعلق قائم رکھتے ہیں
- سرورز کو مقامی اور دور دراز تعیناتی کے منظرناموں کے ساتھ بہتر بنایا گیا
ابتدائی ڈھانچے کی تشکیل نو: سرور اور کلائنٹ کے ابتدائی ڈھانچے کی مکمل تبدیلی
- سرور ابتدائیات: وسائل (ڈیٹا سورس)، پرامپٹس (ٹیمپلیٹس)، آلات (قابل عمل فنکشنز) تفصیلی وضاحت اور مثالوں کے ساتھ
- کلائنٹ ابتدائیات: سیمپلنگ (LLM مکملات)، انضمام (صارف ان پٹ)، لاگنگ (ڈی بگنگ/مانیٹرنگ)
- موجودہ دریافت (*/list)، بازیافت (*/get)، اور اجرا (*/call) طریقہ کار کے پیٹرنز کے ساتھ تازہ کاری
پروٹوکول ساخت: دو تہہ والی آرکیٹیکچر ماڈل متعارف کروایا گیا
- ڈیٹا تہہ: JSON-RPC 2.0 بنیاد کے ساتھ لائف سائیکل مینجمنٹ اور ابتدائیات
- ٹرانسپورٹ تہہ: STDIO (مقامی) اور SSE کے ساتھ HTTP اسٹریمیبل دور دراز ٹرانسپورٹ میکانزم
سیکیورٹی فریم ورک: واضح یوزر رضا مندی، ڈیٹا پرائیویسی تحفظ، ٹولز کے محفوظ اجرا، اور ٹرانسپورٹ تہہ کی سیکیورٹی سمیت جامع سیکیورٹی اصول
ابلاغ کے نمونے: پروٹوکول پیغامات کو انیشئلائزیشن، دریافت، اجرا، اور نوٹیفیکیشن فلو دکھانے کے لیے اپ ڈیٹ کیا گیا
کوڈ کی مثالیں: موجودہ MCP SDK پیٹرنز کی عکاسی کے لیے کثیر زبان کی مثالیں (.NET، جاوا، پائتھون، جاوا اسکرپٹ) تازہ کاری کی گئیں

سیکیورٹی (02-Security/) - جامع سیکیورٹی کی اصلاح

معیارات کے مطابق ہونا: MCP تخصیص 2025-06-18 سیکیورٹی تقاضوں کے ساتھ مکمل ہم آہنگی
تصدیق کی ترقی: کسٹم OAuth سرورز سے بیرونی شناخت فراہم کنندہ کی نمائندگی (Microsoft Entra ID) تک کی ترقی دستاویزی
AI مخصوص خطرہ تجزیہ: جدید AI حملہ آور راستوں کا بہتر احاطہ
- حقیقی دنیا کی مثالوں کے ساتھ تفصیلی پرامپٹ انجیکشن حملہ منظرنامے
- ٹول زہر آلودگی کے طریقہ کار اور "رگ پل" حملے کے پیٹرنز
- کانٹیکسٹ ونڈو زہر آلودگی اور ماڈل الجھن کے حملے
مائیکروسافٹ AI سیکیورٹی حل: مائیکروسافٹ سیکیورٹی ایکو سسٹم کا جامع احاطہ
- AI پرامپٹ شیلڈز کے ساتھ اعلی درجے کا پتہ لگانا، اسپاٹ لائٹنگ، اور ڈیلیمٹر تکنیکیں
- ایژر کانٹینٹ سیفٹی انٹیگریشن پیٹرنز
- GitHub ایڈوانسڈ سیکیورٹی برائے سپلائی چین تحفظ
جدید خطرہ تخفیف: تفصیلی سیکیورٹی کنٹرولز برائے
- MCP مخصوص سیشن ہائی جیکنگ حملہ منظرنامے اور کرپٹوگرافک سیشن ID تقاضے
- MCP پراکسی منظرناموں میں کنفیوژڈ ڈیپٹی مسائل کے لیے واضح رضا مندی کی ضروریات
- ٹوکن پاس تھرو کی کمزوریوں کے لیے لازمی تصدیقی کنٹرولز
سپلائی چین سیکیورٹی: AI سپلائی چین کا وسیع احاطہ جس میں فاؤنڈیشن ماڈلز، ایمبیڈڈ سروسز، کانٹیکسٹ پرووائیڈرز، اور تیسرے فریق APIs شامل ہیں
بنیادی سیکیورٹی: زیرو ٹرسٹ آرکیٹیکچر اور مائیکروسافٹ سیکیورٹی ایکو سسٹم سمیت انٹرپرائز سیکیورٹی پیٹرنز کے ساتھ بہتر انٹیگریشن
وسائل کی تنظیم: قسم کے ذریعہ جامع وسائل کے لنکس کی درجہ بندی (سرکاری دستاویزات، معیارات، تحقیق، مائیکروسافٹ کے حل، نفاذ کے رہنما)

دستاویزات کی معیار میں بہتری

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

16 جولائی 2025

README اور نیویگیشن میں بہتریاں

README.md میں نصاب کی نیویگیشن کو مکمل طور پر نئے سرے سے ڈیزائن کیا گیا
<details> ٹیگز کی جگہ زیادہ قابل رسائی ٹیبل بیسڈ فارمیٹ استعمال کیا گیا
نئے "alternative_layouts" فولڈر میں متبادل لے آؤٹ کے اختیارات تخلیق کیے گئے
کارڈ بیسڈ، ٹیبد اسٹائل، اور اکارڈین اسٹائل نیویگیشن کی مثالیں شامل کی گئیں
مستودع کی ساخت کے سیکشن کو تمام تازہ ترین فائلوں کے ساتھ اپ ڈیٹ کیا گیا
"How to Use This Curriculum" سیکشن کو واضح سفارشات کے ساتھ بہتر بنایا گیا
MCP تخصیص کے لنکس کو درست URLs کی طرف اپ ڈیٹ کیا گیا
نصاب کی ساخت میں کانٹیکسٹ انجینئرنگ سیکشن (5.14) شامل کیا گیا

مطالعہ گائیڈ کی تازہ کاری

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

کمیونٹی کی شراکتیں (06-CommunityContributions/)

امیج جنریشن کے لیے MCP سرورز کے بارے میں تفصیلی معلومات شامل کی گئیں
VSCode میں Claude کے استعمال پر جامع سیکشن شامل کیا گیا
Cline ٹرمینل کلائنٹ کی سیٹ اپ اور استعمال کے ہدایات شامل کی گئیں
MCP کلائنٹ سیکشن کو تمام مقبول کلائنٹ آپشنز کے ساتھ اپ ڈیٹ کیا گیا
شراکتی مثالوں کو زیادہ درست کوڈ نمونوں کے ساتھ بہتر بنایا گیا

ایڈوانسڈ موضوعات (05-AdvancedTopics/)

تمام تخصصی موضوعاتی فولڈرز کو منظم اور مستقل ناموں کے ساتھ ترتیب دیا گیا
کانٹیکسٹ انجینئرنگ کے مواد اور مثالیں شامل کی گئیں
Foundry ایجنٹ انٹیگریشن کی دستاویزات شامل کی گئیں
Entra ID سیکیورٹی انٹیگریشن کی دستاویزات کو بہتر بنایا گیا

11 جون 2025

ابتدائی تخلیق

MCP for Beginners نصاب کا پہلا ورژن جاری کیا گیا
تمام 10 بنیادی سیکشنز کے لیے بنیادی ڈھانچہ تیار کیا گیا
نیویگیشن کے لیے بصری نصاب نقشہ نافذ کیا گیا
متعدد پروگرامنگ زبانوں میں ابتدائی نمونہ پروجیکٹس شامل کیے گئے

شروع کریں (03-GettingStarted/)

پہلے سرور نفاذ کی مثالیں تیار کی گئیں
کلائنٹ ڈویلپمنٹ کی رہنمائی شامل کی گئی
LLM کلائنٹ انٹیگریشن کی ہدایات شامل کی گئیں
VS Code انٹیگریشن کی دستاویزات شامل کی گئیں
سرور بھیجے گئے ایونٹس (SSE) کے سرور کی مثالیں نافذ کی گئیں

بنیادی تصورات (01-CoreConcepts/)

کلائنٹ-سرور آرکیٹیکچر کی تفصیلی وضاحت شامل کی گئی
کلیدی پروٹوکول اجزاء پر دستاویزات تیار کی گئیں
MCP میں پیغام رسانی کے نمونوں کو دستاویزی شکل دی گئی

23 مئی 2025

مستودع کی ساخت

بنیادی فولڈر ساخت کے ساتھ مستودع کا آغاز کیا گیا
ہر بڑے سیکشن کے لیے README فائلیں تیار کی گئیں
ترجمے کا انفراسٹرکچر قائم کیا گیا
تصویری وسائل اور خاکے شامل کیے گئے

دستاویزات

نصاب کا جائزہ لینے والی ابتدائی README.md تیار کی گئی
CODE_OF_CONDUCT.md اور SECURITY.md شامل کیے گئے
مدد حاصل کرنے کے لیے SUPPORT.md قائم کیا گیا
ابتدائی مطالعہ گائیڈ کا ڈھانچہ تیار کیا گیا

15 اپریل 2025

منصوبہ بندی اور فریم ورک

MCP for Beginners نصاب کے لیے ابتدائی منصوبہ بندی
تعلیمی مقاصد اور ہدف سامعین کی تعریف
نصاب کی 10 سیکشن ساخت کا خاکہ
مثالوں اور کیس اسٹڈیز کے لیے تصوری فریم ورک تیار کیا گیا
کلیدی تصورات کے لیے ابتدائی نمونے تیار کیے گئے

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

68 KiB Raw Permalink Blame History