Skip to content

Latest commit

 

History

History
249 lines (187 loc) · 24.1 KB

File metadata and controls

249 lines (187 loc) · 24.1 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 بپیوندید و با کارشناسان و توسعه‌دهندگان دیگر آشنا شوید

🌐 پشتیبانی چندزبانه

پشتیبانی شده از طریق GitHub Action (خودکار و همیشه به‌روز)

عربی | بنگالی | بلغاری | برمه‌ای (میانمار) | چینی (ساده‌شده) | چینی (سنتی، هنگ‌کنگ) | چینی (سنتی، ماکائو) | چینی (سنتی، تایوان) | کرواتی | چکی | دانمارکی | هلندی | فنلاندی | فرانسوی | آلمانی | یونانی | عبری | هندی | مجاری | اندونزیایی | ایتالیایی | ژاپنی | کره‌ای | مالایی | مراتی | نپالی | نروژی | فارسی (Farsi) | لهستانی | پرتغالی (برزیل) | پرتغالی (پرتغال) | پنجابی (گورمخی) | رومانیایی | روسی | صربی (سیریلیک) | اسلواکی | اسلوونیایی | اسپانیایی | سواحیلی | سوئدی | تاگالوگ (فیلیپینی) | تایلندی | ترکی | اوکراینی | اردو | ویتنامی

🚀 برنامه آموزشی پروتکل مدل کانتکست (MCP) برای مبتدیان

آموزش MCP با مثال‌های کدنویسی عملی در C#، جاوا، جاوااسکریپت، راست، پایتون و تایپ‌اسکریپت

🧠 مروری بر برنامه آموزشی پروتکل مدل کانتکست

پروتکل مدل کانتکست (MCP) یک چارچوب پیشرفته است که برای استانداردسازی تعاملات بین مدل‌های هوش مصنوعی و برنامه‌های کلاینت طراحی شده است. این برنامه آموزشی متن‌باز، مسیر یادگیری ساختاریافته‌ای را ارائه می‌دهد که شامل مثال‌های کدنویسی عملی و موارد استفاده واقعی در زبان‌های برنامه‌نویسی محبوب مانند C#، جاوا، جاوااسکریپت، تایپ‌اسکریپت و پایتون است.

چه توسعه‌دهنده هوش مصنوعی باشید، چه معمار سیستم یا مهندس نرم‌افزار، این راهنما منبع جامعی برای تسلط بر اصول MCP و استراتژی‌های پیاده‌سازی آن است.

🔗 منابع رسمی MCP

  • 📘 مستندات MCP – آموزش‌ها و راهنماهای کاربری دقیق
  • 📜 مشخصات MCP – معماری پروتکل و مراجع فنی
  • 📜 مشخصات اصلی MCP – مراجع فنی قدیمی (ممکن است جزئیات بیشتری داشته باشد)
  • 🧑‍💻 مخزن GitHub MCP – SDKها، ابزارها و نمونه کدهای متن‌باز
  • 🌐 جامعه MCP – به بحث‌ها بپیوندید و به جامعه کمک کنید

➡️ تماشای رویداد MCP Dev Days

برای دو روز بینش فنی عمیق، ارتباط با جامعه و یادگیری عملی در رویداد مجازی MCP Dev Days آماده شوید. این رویداد به پروتکل مدل کانتکست (MCP) اختصاص دارد – استاندارد نوظهوری که بین مدل‌های هوش مصنوعی و ابزارهای مورد استفاده آن‌ها پل می‌زند.
می‌توانید با ثبت‌نام در صفحه رویداد ما، MCP Dev Days را تماشا کنید: https://aka.ms/mcpdevdays.

روز اول: بهره‌وری MCP، ابزارهای توسعه و جامعه:

این روز به توانمندسازی توسعه‌دهندگان برای استفاده از MCP در جریان کاری توسعه‌دهنده و جشن گرفتن جامعه شگفت‌انگیز MCP اختصاص دارد.
ما با اعضای جامعه و شرکایی مانند Arcade، Block، Okta و Neon همراه خواهیم بود تا ببینیم چگونه با مایکروسافت همکاری می‌کنند تا یک اکوسیستم MCP باز و قابل گسترش را شکل دهند.

  • دموهای واقعی در VS Code، Visual Studio، GitHub Copilot و ابزارهای محبوب جامعه
  • جریان‌های کاری توسعه‌دهنده مبتنی بر کانتکست
  • جلسات و بینش‌های جامعه‌محور
    چه تازه با MCP آشنا شده باشید یا در حال ساخت با آن باشید، روز اول با الهام و نکات عملی شما را آماده می‌کند.

روز دوم: ساخت سرورهای MCP با اطمینان

این روز برای سازندگان MCP است. ما به استراتژی‌های پیاده‌سازی و بهترین شیوه‌ها برای ایجاد سرورهای MCP و ادغام MCP در جریان‌های کاری هوش مصنوعی خواهیم پرداخت.

موضوعات شامل:

  • ساخت سرورهای MCP و ادغام آن‌ها در تجربیات عامل
  • توسعه مبتنی بر پرامپت
  • بهترین شیوه‌های امنیتی
  • استفاده از بلوک‌های سازنده مانند Functions، ACA و مدیریت API
  • هم‌ترازی رجیستری و ابزارها (1P + 3P)

اگر توسعه‌دهنده، سازنده ابزار یا استراتژیست محصول هوش مصنوعی هستید، این روز پر از بینش‌هایی است که برای ساخت راه‌حل‌های MCP مقیاس‌پذیر، امن و آماده برای آینده نیاز دارید.

🧭 مروری بر برنامه آموزشی MCP

📚 ساختار کامل برنامه آموزشی

ماژول موضوع توضیحات لینک
ماژول 1-3: اصول اولیه
00 معرفی MCP مروری بر پروتکل مدل کانتکست و اهمیت آن در خطوط لوله هوش مصنوعی بیشتر بخوانید
01 توضیح مفاهیم اصلی بررسی عمیق مفاهیم اصلی MCP بیشتر بخوانید
02 امنیت در MCP تهدیدات امنیتی و بهترین شیوه‌ها بیشتر بخوانید
03 شروع کار با MCP تنظیم محیط، سرورها/کلاینت‌های پایه، ادغام بیشتر بخوانید
ماژول 3: ساخت اولین سرور و کلاینت
3.1 اولین سرور ساخت اولین سرور MCP راهنما
3.2 اولین کلاینت توسعه یک کلاینت MCP پایه راهنما
3.3 کلاینت با LLM ادغام مدل‌های زبانی بزرگ راهنما
3.4 ادغام با VS Code استفاده از سرورهای MCP در VS Code راهنما
3.5 سرور SSE ساخت سرورها با استفاده از Server-Sent Events راهنما
3.6 استریم HTTP پیاده‌سازی استریم HTTP در MCP راهنما
3.7 ابزار هوش مصنوعی استفاده از ابزار هوش مصنوعی با MCP راهنما
3.8 تست تست پیاده‌سازی سرور MCP راهنما
3.9 استقرار استقرار سرورهای MCP در محیط تولید راهنما
ماژول 4-5: عملی و پیشرفته
04 پیاده‌سازی عملی SDKها، اشکال‌زدایی، تست، قالب‌های پرامپت قابل استفاده مجدد بیشتر بخوانید
05 موضوعات پیشرفته در MCP هوش مصنوعی چندوجهی، مقیاس‌پذیری، استفاده در سطح سازمانی بیشتر بخوانید
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 احراز هویت با Microsoft Entra ID راهنما
5.13 ادغام Foundry ادغام با Azure AI Foundry راهنما
5.14 مهندسی کانتکست تکنیک‌های مهندسی کانتکست مؤثر راهنما
ماژول 6-10: جامعه و بهترین شیوه‌ها
06 مشارکت‌های جامعه نحوه مشارکت در اکوسیستم MCP راهنما
07 درس‌هایی از پذیرش اولیه داستان‌های پیاده‌سازی در دنیای واقعی راهنما
08 بهترین شیوه‌ها برای MCP عملکرد، تحمل خطا، تاب‌آوری راهنما
09 مطالعات موردی MCP نمونه‌های عملی پیاده‌سازی راهنما
10 کارگاه عملی ساخت سرور MCP با ابزار هوش مصنوعی آزمایشگاه

💻 پروژه‌های نمونه کد

نمونه‌های ساده ماشین حساب MCP

زبان توضیحات لینک
C# نمونه سرور MCP مشاهده کد
Java ماشین حساب MCP مشاهده کد
JavaScript دموی MCP مشاهده کد
Python سرور MCP مشاهده کد
TypeScript نمونه MCP مشاهده کد

پیاده‌سازی‌های پیشرفته MCP

زبان توضیحات لینک
C# نمونه پیشرفته مشاهده کد
Java با Spring نمونه اپلیکیشن کانتینری مشاهده کد
JavaScript نمونه پیشرفته مشاهده کد
Python پیاده‌سازی پیچیده مشاهده کد
TypeScript نمونه کانتینری مشاهده کد

🎯 پیش‌نیازهای یادگیری MCP

برای بهره‌برداری کامل از این دوره، باید:

  • دانش پایه برنامه‌نویسی در حداقل یکی از زبان‌های زیر داشته باشید: C#، Java، JavaScript، Python یا TypeScript

  • درک مدل کلاینت-سرور و APIها

  • آشنایی با مفاهیم REST و HTTP

  • (اختیاری) پیش‌زمینه‌ای در مفاهیم هوش مصنوعی/یادگیری ماشین

  • شرکت در بحث‌های جامعه ما برای دریافت پشتیبانی

📚 راهنمای مطالعه و منابع

این مخزن شامل منابع متعددی است که به شما کمک می‌کند به طور مؤثر یاد بگیرید و پیش بروید:

راهنمای مطالعه

یک راهنمای مطالعه جامع برای کمک به شما در پیمایش این مخزن در دسترس است. این راهنما شامل:

  • نقشه تصویری برنامه درسی که تمام موضوعات پوشش داده شده را نشان می‌دهد
  • تجزیه و تحلیل دقیق هر بخش از مخزن
  • راهنمایی در مورد نحوه استفاده از پروژه‌های نمونه
  • مسیرهای یادگیری پیشنهادی برای سطوح مهارتی مختلف
  • منابع اضافی برای تکمیل مسیر یادگیری شما

تغییرات

ما یک تغییرات دقیق را نگهداری می‌کنیم که تمام به‌روزرسانی‌های مهم در مواد درسی را شامل می‌شود، از جمله:

  • اضافه شدن محتوای جدید
  • تغییرات ساختاری
  • بهبود ویژگی‌ها
  • به‌روزرسانی مستندات

🛠️ نحوه استفاده مؤثر از این دوره

هر درس در این راهنما شامل موارد زیر است:

  1. توضیحات واضح مفاهیم MCP
  2. نمونه‌های کد زنده در زبان‌های مختلف
  3. تمرین‌هایی برای ساخت برنامه‌های واقعی MCP
  4. منابع اضافی برای یادگیرندگان پیشرفته

🌟 تشکر از جامعه

تشکر ویژه از Microsoft Valued Professional Shivam Goyal برای ارائه نمونه‌های کد مهم.

📜 اطلاعات مجوز

این محتوا تحت مجوز MIT License منتشر شده است. برای شرایط و ضوابط، به LICENSE مراجعه کنید.

🤝 دستورالعمل‌های مشارکت

این پروژه از مشارکت‌ها و پیشنهادات استقبال می‌کند. اکثر مشارکت‌ها نیاز به توافق با یک
Contributor License Agreement (CLA) دارند که اعلام می‌کند شما حق دارید و واقعاً این حق را دارید که به ما اجازه دهید از مشارکت شما استفاده کنیم. برای جزئیات، به
https://cla.opensource.microsoft.com مراجعه کنید.

هنگامی که یک درخواست pull ارسال می‌کنید، یک ربات CLA به طور خودکار تعیین می‌کند که آیا نیاز به ارائه CLA دارید و درخواست را به درستی تزئین می‌کند (مثلاً بررسی وضعیت، نظر). فقط دستورالعمل‌های ارائه شده توسط ربات را دنبال کنید. شما فقط یک بار نیاز به انجام این کار دارید برای تمام مخازن استفاده کننده از CLA ما.

این پروژه Microsoft Open Source Code of Conduct را پذیرفته است.
برای اطلاعات بیشتر به Code of Conduct FAQ مراجعه کنید یا با opencode@microsoft.com تماس بگیرید.

📂 ساختار مخزن

این مخزن به صورت زیر سازماندهی شده است:

  • برنامه درسی اصلی (00-10): محتوای اصلی که در ده ماژول متوالی سازماندهی شده است
  • images/: نمودارها و تصاویر استفاده شده در سراسر برنامه درسی
  • translations/: پشتیبانی چندزبانه با ترجمه‌های خودکار
  • translated_images/: نسخه‌های محلی‌سازی شده از نمودارها و تصاویر
  • study_guide.md: راهنمای جامع برای پیمایش مخزن
  • changelog.md: سوابق تمام تغییرات مهم در مواد درسی
  • mcp.json: فایل پیکربندی برای مشخصات MCP
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: اسناد حاکمیتی پروژه

🎒 دوره‌های دیگر

تیم ما دوره‌های دیگری نیز تولید می‌کند! بررسی کنید:

™️ اطلاعیه علائم تجاری

این پروژه ممکن است شامل علائم تجاری یا لوگوهایی برای پروژه‌ها، محصولات یا خدمات باشد. استفاده مجاز از علائم تجاری یا لوگوهای مایکروسافت باید مطابق با
راهنمای علائم تجاری و برند مایکروسافت باشد.
استفاده از علائم تجاری یا لوگوهای مایکروسافت در نسخه‌های اصلاح شده این پروژه نباید باعث سردرگمی یا القای حمایت مایکروسافت شود.
هرگونه استفاده از علائم تجاری یا لوگوهای شخص ثالث تابع سیاست‌های آن‌ها است.

سلب مسئولیت:
این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما تلاش می‌کنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نادرستی‌ها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه می‌شود از ترجمه حرفه‌ای انسانی استفاده کنید. ما مسئولیتی در قبال سوء تفاهم‌ها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.