برای شروع استفاده از این منابع، مراحل زیر را دنبال کنید:
- فورک کردن مخزن: کلیک کنید
- کلون کردن مخزن:
git clone https://github.com/microsoft/mcp-for-beginners.git - به دیسکورد Azure AI Foundry بپیوندید و با کارشناسان و توسعهدهندگان دیگر آشنا شوید
عربی | بنگالی | بلغاری | برمهای (میانمار) | چینی (سادهشده) | چینی (سنتی، هنگکنگ) | چینی (سنتی، ماکائو) | چینی (سنتی، تایوان) | کرواتی | چکی | دانمارکی | هلندی | فنلاندی | فرانسوی | آلمانی | یونانی | عبری | هندی | مجاری | اندونزیایی | ایتالیایی | ژاپنی | کرهای | مالایی | مراتی | نپالی | نروژی | فارسی (Farsi) | لهستانی | پرتغالی (برزیل) | پرتغالی (پرتغال) | پنجابی (گورمخی) | رومانیایی | روسی | صربی (سیریلیک) | اسلواکی | اسلوونیایی | اسپانیایی | سواحیلی | سوئدی | تاگالوگ (فیلیپینی) | تایلندی | ترکی | اوکراینی | اردو | ویتنامی
پروتکل مدل کانتکست (MCP) یک چارچوب پیشرفته است که برای استانداردسازی تعاملات بین مدلهای هوش مصنوعی و برنامههای کلاینت طراحی شده است. این برنامه آموزشی متنباز، مسیر یادگیری ساختاریافتهای را ارائه میدهد که شامل مثالهای کدنویسی عملی و موارد استفاده واقعی در زبانهای برنامهنویسی محبوب مانند C#، جاوا، جاوااسکریپت، تایپاسکریپت و پایتون است.
چه توسعهدهنده هوش مصنوعی باشید، چه معمار سیستم یا مهندس نرمافزار، این راهنما منبع جامعی برای تسلط بر اصول MCP و استراتژیهای پیادهسازی آن است.
- 📘 مستندات MCP – آموزشها و راهنماهای کاربری دقیق
- 📜 مشخصات MCP – معماری پروتکل و مراجع فنی
- 📜 مشخصات اصلی MCP – مراجع فنی قدیمی (ممکن است جزئیات بیشتری داشته باشد)
- 🧑💻 مخزن GitHub MCP – SDKها، ابزارها و نمونههای کد متنباز
- 🌐 جامعه MCP – به بحثها بپیوندید و به جامعه کمک کنید
| ماژول | موضوع | توضیحات | لینک |
|---|---|---|---|
| ماژول ۱-۳: اصول اولیه | |||
| ۰۰ | معرفی MCP | مروری بر پروتکل مدل کانتکست و اهمیت آن در خطوط لوله هوش مصنوعی | بیشتر بخوانید |
| ۰۱ | توضیح مفاهیم اصلی | بررسی عمیق مفاهیم اصلی MCP | بیشتر بخوانید |
| ۰۲ | امنیت در MCP | تهدیدات امنیتی و بهترین روشها | بیشتر بخوانید |
| ۰۳ | شروع کار با MCP | تنظیم محیط، سرورها/کلاینتهای پایه، یکپارچهسازی | بیشتر بخوانید |
| ماژول ۳: ساخت اولین سرور و کلاینت | |||
| ۳.۱ | اولین سرور | ساخت اولین سرور MCP | راهنما |
| ۳.۲ | اولین کلاینت | توسعه یک کلاینت MCP پایه | راهنما |
| ۳.۳ | کلاینت با LLM | یکپارچهسازی مدلهای زبانی بزرگ | راهنما |
| ۳.۴ | یکپارچهسازی با VS Code | استفاده از سرورهای MCP در VS Code | راهنما |
| ۳.۵ | سرور stdio | ساخت سرورها با استفاده از انتقال stdio | راهنما |
| ۳.۶ | استریم HTTP | پیادهسازی استریم HTTP در MCP | راهنما |
| ۳.۷ | ابزار هوش مصنوعی | استفاده از ابزار هوش مصنوعی با MCP | راهنما |
| ۳.۸ | تست | تست پیادهسازی سرور MCP | راهنما |
| ۳.۹ | استقرار | استقرار سرورهای MCP در محیط تولید | راهنما |
| ماژول ۴-۵: عملی و پیشرفته | |||
| ۰۴ | پیادهسازی عملی | SDKها، اشکالزدایی، تست، قالبهای قابل استفاده مجدد | بیشتر بخوانید |
| ۰۵ | موضوعات پیشرفته در MCP | هوش مصنوعی چندوجهی، مقیاسپذیری، استفاده سازمانی | بیشتر بخوانید |
| ۵.۱ | یکپارچهسازی با Azure | یکپارچهسازی MCP با Azure | راهنما |
| ۵.۲ | چندوجهی | کار با چند وجه مختلف | راهنما |
| ۵.۳ | دمو OAuth2 | پیادهسازی احراز هویت OAuth2 | راهنما |
| ۵.۴ | کانتکستهای ریشه | درک و پیادهسازی کانتکستهای ریشه | راهنما |
| ۵.۵ | مسیریابی | استراتژیهای مسیریابی MCP | راهنما |
| ۵.۶ | نمونهگیری | تکنیکهای نمونهگیری در MCP | راهنما |
| ۵.۷ | مقیاسپذیری | مقیاسپذیری پیادهسازیهای MCP | راهنما |
| ۵.۸ | امنیت | ملاحظات امنیتی پیشرفته | راهنما |
| ۵.۹ | جستجوی وب | پیادهسازی قابلیتهای جستجوی وب | راهنما |
| ۵.۱۰ | استریم بلادرنگ | ساخت قابلیت استریم بلادرنگ | راهنما |
| ۵.۱۱ | جستجوی بلادرنگ | پیادهسازی جستجوی بلادرنگ | راهنما |
| ۵.۱۲ | احراز هویت Entra ID | احراز هویت با Microsoft Entra ID | راهنما |
| ۵.۱۳ | یکپارچهسازی Foundry | یکپارچهسازی با Azure AI Foundry | راهنما |
| ۵.۱۴ | مهندسی کانتکست | تکنیکهای مهندسی کانتکست مؤثر | راهنما |
| ماژول ۶-۱۰: جامعه و بهترین روشها | |||
| ۰۶ | مشارکتهای جامعه | نحوه مشارکت در اکوسیستم MCP | راهنما |
| ۰۷ | بینشهایی از پذیرش اولیه | داستانهای پیادهسازی در دنیای واقعی | راهنما |
| ۰۸ | بهترین روشها برای MCP | عملکرد، تحمل خطا، مقاومت | راهنما |
| ۰۹ | مطالعات موردی MCP | مثالهای پیادهسازی عملی | راهنما |
| ۱۰ | کارگاه عملی | ساخت یک سرور MCP با ابزار هوش مصنوعی | آزمایشگاه |
| زبان | توضیحات | لینک |
|---|---|---|
| C# | مثال سرور MCP | مشاهده کد |
| جاوا | ماشینحساب MCP | مشاهده کد |
| جاوااسکریپت | دمو MCP | مشاهده کد |
| پایتون | سرور MCP | مشاهده کد |
| تایپاسکریپت | مثال MCP | مشاهده کد |
| راست | مثال MCP | مشاهده کد |
| زبان | توضیحات | لینک |
|---|---|---|
| C# | نمونه پیشرفته | View Code |
| Java with Spring | مثال برنامه کانتینری | View Code |
| JavaScript | نمونه پیشرفته | View Code |
| Python | پیادهسازی پیچیده | View Code |
| TypeScript | نمونه کانتینری | View Code |
برای بهرهبرداری کامل از این دوره آموزشی، باید موارد زیر را داشته باشید:
-
دانش پایه برنامهنویسی در حداقل یکی از زبانهای زیر: C#، Java، JavaScript، Python یا TypeScript
-
درک مدل کلاینت-سرور و APIها
-
آشنایی با مفاهیم REST و HTTP
-
(اختیاری) پیشزمینهای در مفاهیم AI/ML
-
شرکت در بحثهای جامعه ما برای دریافت پشتیبانی
این مخزن شامل منابع متعددی است که به شما کمک میکند به طور مؤثر یاد بگیرید و پیش بروید:
یک راهنمای مطالعه جامع در دسترس است که به شما کمک میکند این مخزن را به طور مؤثر مرور کنید. این راهنما شامل موارد زیر است:
- نقشه تصویری برنامه درسی که تمام موضوعات پوشش داده شده را نشان میدهد
- توضیحات دقیق هر بخش از مخزن
- راهنمایی در مورد نحوه استفاده از پروژههای نمونه
- مسیرهای یادگیری پیشنهادی برای سطوح مهارتی مختلف
- منابع اضافی برای تکمیل مسیر یادگیری شما
ما یک تغییرات دقیق را نگهداری میکنیم که تمام بهروزرسانیهای مهم در مواد آموزشی را شامل میشود، از جمله:
- اضافه شدن محتوای جدید
- تغییرات ساختاری
- بهبود ویژگیها
- بهروزرسانی مستندات
هر درس در این راهنما شامل موارد زیر است:
- توضیحات واضح مفاهیم MCP
- مثالهای کدنویسی زنده در زبانهای مختلف
- تمرینهایی برای ساخت برنامههای واقعی MCP
- منابع اضافی برای یادگیرندگان پیشرفته
آماده شوید برای دو روز بینش فنی عمیق، ارتباط با جامعه، و یادگیری عملی در MCP Dev Days، یک رویداد مجازی که به پروتکل مدل کانتکست (MCP) اختصاص دارد — استاندارد نوظهوری که مدلهای هوش مصنوعی و ابزارهای مورد استفاده آنها را به هم متصل میکند.
میتوانید MCP Dev Days را با ثبتنام در صفحه رویداد ما تماشا کنید: https://aka.ms/mcpdevdays.
این روز به توانمندسازی توسعهدهندگان برای استفاده از MCP در جریان کاری توسعهدهنده و جشن گرفتن جامعه شگفتانگیز MCP اختصاص دارد. ما با اعضای جامعه و شرکایی مانند Arcade، Block، Okta و Neon همراه خواهیم بود تا ببینیم چگونه با مایکروسافت همکاری میکنند تا یک اکوسیستم MCP باز و قابل توسعه را شکل دهند.
دموهای واقعی در VS Code، Visual Studio، GitHub Copilot و ابزارهای محبوب جامعه
جریانهای کاری توسعهدهنده مبتنی بر کانتکست
جلسات و بینشهای جامعهمحور
چه تازه با MCP آشنا شده باشید یا در حال ساخت با آن باشید، روز اول با الهام و نکات عملی شما را آماده میکند.
این روز برای سازندگان MCP است. ما به استراتژیهای پیادهسازی و بهترین شیوهها برای ایجاد سرورهای MCP و ادغام MCP در جریانهای کاری هوش مصنوعی میپردازیم.
- ساخت سرورهای MCP و ادغام آنها در تجربیات عامل
- توسعه مبتنی بر پرامپت
- بهترین شیوههای امنیتی
- استفاده از بلوکهای سازنده مانند Functions، ACA و مدیریت API
- همترازی رجیستری و ابزارها (1P + 3P)
اگر توسعهدهنده، سازنده ابزار یا استراتژیست محصول هوش مصنوعی هستید، این روز پر از بینشهایی است که برای ساخت راهحلهای MCP مقیاسپذیر، امن و آماده برای آینده نیاز دارید.
در جلسات ویدیویی فشرده یاد بگیرید چگونه سرورهای MCP ایجاد کنید، با VS Code ادغام کنید و به صورت حرفهای در Azure مستقر کنید، بر اساس محتوای دوره MCP برای مبتدیان. با مهارتهای عملی در فناوری که شرکتهای بزرگ در حال حاضر از آن استفاده میکنند، از این دوره خارج شوید.
تشکر از Microsoft Valued Professional Shivam Goyal برای ارائه نمونههای کد مهم.
این محتوا تحت مجوز MIT منتشر شده است. برای شرایط و ضوابط، به LICENSE مراجعه کنید.
این پروژه از مشارکتها و پیشنهادات استقبال میکند. اکثر مشارکتها نیاز دارند که شما با یک
توافقنامه مجوز مشارکتکننده (CLA) موافقت کنید که اعلام میکند شما حق دارید و واقعاً این حق را دارید که به ما
حقوق استفاده از مشارکت خود را اعطا کنید. برای جزئیات، به
https://cla.opensource.microsoft.com مراجعه کنید.
هنگامی که یک درخواست pull ارسال میکنید، یک ربات CLA به طور خودکار تعیین میکند که آیا شما نیاز دارید
CLA ارائه دهید و درخواست را به طور مناسب تزئین میکند (مثلاً بررسی وضعیت، نظر). به سادگی دستورالعملهای
ارائه شده توسط ربات را دنبال کنید. شما فقط یک بار نیاز به انجام این کار دارید برای تمام مخازن استفادهکننده از CLA ما.
این پروژه کد رفتار منبع باز مایکروسافت را پذیرفته است.
برای اطلاعات بیشتر به سؤالات متداول کد رفتار مراجعه کنید یا
با 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: اسناد حاکمیتی پروژه
تیم ما دورههای دیگری نیز تولید میکند! بررسی کنید:
- AI Agents For Beginners
- Generative AI for Beginners using .NET
- Generative AI for Beginners using JavaScript
- Generative AI for Beginners
- Generative AI for Beginners using Java
- ML for Beginners
- Data Science for Beginners
- AI for Beginners
- Cybersecurity for Beginners
- Web Dev for Beginners
- IoT for Beginners
- XR Development for Beginners
- Mastering GitHub Copilot for AI Paired Programming
- Mastering GitHub Copilot for C#/.NET Developers
- Choose Your Own Copilot Adventure
این پروژه ممکن است شامل علائم تجاری یا لوگوهایی برای پروژهها، محصولات یا خدمات باشد. استفاده مجاز از علائم تجاری یا لوگوهای مایکروسافت باید مطابق با
دستورالعملهای علامت تجاری و برند مایکروسافت باشد.
استفاده از علائم تجاری یا لوگوهای مایکروسافت در نسخههای اصلاحشده این پروژه نباید باعث سردرگمی شود یا حمایت مایکروسافت را القا کند.
هرگونه استفاده از علائم تجاری یا لوگوهای شخص ثالث باید مطابق با سیاستهای آنها باشد.
سلب مسئولیت:
این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما تلاش میکنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمههای خودکار ممکن است شامل خطاها یا نادرستیها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه میشود از ترجمه حرفهای انسانی استفاده کنید. ما مسئولیتی در قبال سوء تفاهمها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.