Следвайте тези стъпки, за да започнете да използвате тези ресурси:
- Направете Fork на хранилището: Кликнете
- Клонирайте хранилището:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присъединете се към Azure AI Foundry Discord и се срещнете с експерти и други разработчици
Арабски | Бенгалски | Български | Бирмански (Мианмар) | Китайски (опростен) | Китайски (традиционен, Хонконг) | Китайски (традиционен, Макао) | Китайски (традиционен, Тайван) | Хърватски | Чешки | Датски | Холандски | Фински | Френски | Немски | Гръцки | Иврит | Хинди | Унгарски | Индонезийски | Италиански | Японски | Корейски | Малайски | Маратхи | Непалски | Норвежки | Персийски (фарси) | Полски | Португалски (Бразилия) | Португалски (Португалия) | Панджаби (Гурмуки) | Румънски | Руски | Сръбски (кирилица) | Словашки | Словенски | Испански | Суахили | Шведски | Тагалог (Филипински) | Тайландски | Турски | Украински | Урду | Виетнамски
Model Context Protocol (MCP) е иновативна рамка, създадена за стандартизиране на взаимодействията между AI модели и клиентски приложения. Тази учебна програма с отворен код предлага структурирана учебна пътека, включваща практически примери за програмиране и реални случаи на употреба, в популярни програмни езици като C#, Java, JavaScript, TypeScript и Python.
Независимо дали сте AI разработчик, системен архитект или софтуерен инженер, този наръчник е вашият цялостен ресурс за овладяване на основите на MCP и стратегии за внедряване.
- 📘 Документация за MCP – Подробни уроци и ръководства за потребители
- 📜 Спецификация на MCP – Архитектура на протокола и технически справки
- 📜 Оригинална спецификация на MCP – Технически справки от предишни версии (може да съдържат допълнителни детайли)
- 🧑💻 GitHub хранилище за MCP – 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 автентикация | Автентикация с Microsoft Entra ID | Ръководство |
| 5.13 | Интеграция с Foundry | Интеграция с Azure AI Foundry | Ръководство |
| 5.14 | Инженеринг на контексти | Техники за ефективен инженеринг на контексти | Ръководство |
| 5.15 | MCP Custom Transport | Реализации на персонализиран транспорт | Ръководство |
| Модул 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# | Разширен пример | Преглед на кода |
| Java със Spring | Пример за приложение в контейнер | Преглед на кода |
| JavaScript | Разширен пример | Преглед на кода |
| Python | Сложна реализация | Преглед на кода |
| TypeScript | Пример за контейнер | Преглед на кода |
За да извлечете максимума от тази учебна програма, трябва да имате:
-
Основни познания по програмиране поне на един от следните езици: 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 за начинаещи. Придобийте практически умения в технология, която вече се използва от големи компании.
Да научим за Model Context Protocol (MCP), авангардна рамка, предназначена да стандартизира взаимодействията между AI модели и клиентски приложения. В тази сесия за начинаещи ще ви запознаем с MCP и ще ви насочим към създаването на вашия първи MCP сървър.
JavaScript: https://aka.ms/letslearnmcp-javascript
Благодарности към 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: Документи за управление на проекта
Нашият екип създава и други курсове! Вижте:
- НОВ Edge AI For Beginners
- 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. Въпреки че се стремим към точност, моля, имайте предвид, че автоматичните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия изходен език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален превод от човек. Не носим отговорност за каквито и да било недоразумения или погрешни интерпретации, произтичащи от използването на този превод.