Следвайте тези стъпки, за да започнете да използвате тези ресурси:
- Fork на хранилището: Кликнете
- Клонирайте хранилището:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присъединете се към Azure AI Foundry Discord и се свържете с експерти и други разработчици
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Korean | Malay | Marathi | Nepali | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Model Context Protocol (MCP) е иновативна рамка, създадена за стандартизиране на взаимодействията между AI модели и клиентски приложения. Тази отворена учебна програма предлага структурирана пътека за обучение, включваща практически примери за код и реални случаи на употреба, на популярни програмни езици като C#, Java, JavaScript, TypeScript и Python.
Независимо дали сте AI разработчик, системен архитект или софтуерен инженер, това ръководство е вашият цялостен ресурс за овладяване на основите на MCP и стратегии за внедряване.
- 📘 MCP Документация – Подробни уроци и ръководства за потребители
- 📜 MCP Спецификация – Архитектура на протокола и технически справки
- 📜 Оригинална MCP Спецификация – Наследени технически справки (може да съдържат допълнителни детайли)
- 🧑💻 MCP GitHub Хранилище – Отворени SDK, инструменти и примерен код
- 🌐 MCP Общество – Присъединете се към дискусии и допринасяйте към общността
| Модул | Тема | Описание | Линк |
|---|---|---|---|
| Модул 1-3: Основи | |||
| 00 | Въведение в MCP | Преглед на Model Context Protocol и неговото значение в AI процесите | Прочетете повече |
| 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 | stdio Сървър | Създайте сървъри с използване на stdio транспорт | Ръководство |
| 3.6 | HTTP Стрийминг | Реализирайте HTTP стрийминг в MCP | Ръководство |
| 3.7 | AI Toolkit | Използвайте AI Toolkit с MCP | Ръководство |
| 3.8 | Тестване | Тествайте вашата MCP сървърна имплементация | Ръководство |
| 3.9 | Деплоймънт | Деплойвайте MCP сървъри в продукция | Ръководство |
| Модул 4-5: Практически и напреднали теми | |||
| 04 | Практическа имплементация | SDK, дебъгване, тестване, повторно използваеми шаблони за промптове | Прочетете повече |
| 05 | Напреднали теми в MCP | Мултимодален AI, мащабиране, корпоративна употреба | Прочетете повече |
| 5.1 | Интеграция с Azure | MCP интеграция с Azure | Ръководство |
| 5.2 | Мултимодалност | Работа с множество модалности | Ръководство |
| 5.3 | OAuth2 Демонстрация | Реализирайте OAuth2 автентикация | Ръководство |
| 5.4 | Root Contexts | Разберете и имплементирайте root контексти | Ръководство |
| 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 | Ръководство |
| 5.13 | Интеграция с Foundry | Интегрирайте с Azure AI Foundry | Ръководство |
| 5.14 | Контекстно инженерство | Техники за ефективно контекстно инженерство | Ръководство |
| Модул 6-10: Общество и добри практики | |||
| 06 | Приноси към обществото | Как да допринесете към MCP екосистемата | Ръководство |
| 07 | Уроци от ранното внедряване | Истории за реална имплементация | Ръководство |
| 08 | Най-добри практики за MCP | Производителност, устойчивост на грешки, надеждност | Ръководство |
| 09 | MCP Казуси | Примери за практическа имплементация | Ръководство |
| 10 | Практически семинар | Създаване на MCP сървър с AI Toolkit | Лаборатория |
| Език | Описание | Линк |
|---|---|---|
| C# | Пример за MCP сървър | Преглед на кода |
| Java | MCP Калкулатор | Преглед на кода |
| JavaScript | MCP Демонстрация | Преглед на кода |
| Python | MCP Сървър | Преглед на кода |
| TypeScript | MCP Пример | Преглед на кода |
| Rust | MCP Пример | Преглед на кода |
| Език | Описание | Линк |
|---|---|---|
| C# | Разширен пример | View Code |
| Java със 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, виртуално събитие, посветено на Model Context Protocol (MCP) — нововъзникващия стандарт, който свързва AI моделите и инструментите, на които те разчитат. Можете да гледате MCP Dev Days, като се регистрирате на нашата страница за събития: https://aka.ms/mcpdevdays.
Посветен на овластяването на разработчиците да използват MCP в своя работен процес и празнуването на невероятната MCP общност. Ще се присъединим към членове на общността и партньори като Arcade, Block, Okta и Neon, за да видим как те си сътрудничат с Microsoft за изграждане на отворена, разширяема MCP екосистема.
Реални демонстрации с VS Code, Visual Studio, GitHub Copilot и популярни инструменти на общността
Практически, контекстно-ориентирани работни процеси за разработка
Сесии и прозрения, водени от общността
Независимо дали тепърва започвате с MCP или вече изграждате с него, Ден 1 ще ви вдъхнови и предостави приложими идеи.
Посветен на MCP разработчиците. Ще се задълбочим в стратегии за имплементация и най-добри практики за създаване на MCP сървъри и интегриране на MCP във вашите AI работни процеси.
- Създаване на MCP сървъри и интегрирането им в агентски преживявания
- Разработка, водена от подканвания
- Най-добри практики за сигурност
- Използване на градивни блокове като Functions, ACA и API Management
- Подравняване на регистъра и инструменти (1P + 3P)
Ако сте разработчик, създател на инструменти или AI продуктов стратег, този ден е изпълнен с прозрения, които ви трябват за изграждане на мащабируеми, сигурни и готови за бъдещето MCP решения.
Научете в интензивни видео сесии как да създавате MCP сървъри, да интегрирате с VS Code и да разгръщате професионално на Azure, базирано на съдържанието от учебната програма MCP за начинаещи. Придобийте практически умения в технология, която вече се използва от големи компании.
Благодарности към Microsoft Valued Professional Shivam Goyal за важния принос с примерни кодове.
Това съдържание е лицензирано под MIT License. За условията и разпоредбите вижте LICENSE.
Този проект приветства приноси и предложения. Повечето приноси изискват от вас да се съгласите с Contributor License Agreement (CLA), декларирайки, че имате право и действително предоставяте на нас правата да използваме вашия принос. За подробности посетете https://cla.opensource.microsoft.com.
Когато изпратите pull request, CLA бот автоматично ще определи дали трябва да предоставите CLA и ще украси PR съответно (например статус проверка, коментар). Просто следвайте инструкциите предоставени от бота. Ще трябва да направите това само веднъж за всички репозитории, използващи нашия 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: Документи за управление на проекта
Нашият екип създава и други курсове! Вижте:
- 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
Този проект може да съдържа търговски марки или лога за проекти, продукти или услуги. Употребата на търговски марки или лога на Microsoft трябва да следва Microsoft's Trademark & Brand Guidelines. Употребата на търговски марки или лога на Microsoft в модифицирани версии на този проект не трябва да създава объркване или да предполага спонсорство от Microsoft. Всяка употреба на търговски марки или лога на трети страни трябва да следва политиките на съответните трети страни.
Отказ от отговорност:
Този документ е преведен с помощта на AI услуга за превод Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за недоразумения или погрешни интерпретации, произтичащи от използването на този превод.