Следвайте тези стъпки, за да започнете да използвате тези ресурси:
- Направете Fork на хранилището: Кликнете
- Клонирайте хранилището:
git clone https://github.com/microsoft/mcp-for-beginners.git
- Присъединете се към Azure AI Foundry Discord и се свържете с експерти и други разработчици
🌐 Поддръжка на много езици
Поддържано чрез GitHub Action (Автоматизирано и винаги актуално)
Арабски | Бенгалски | Български | Бирмански (Мианмар) | Китайски (опростен) | Китайски (традиционен, Хонконг) | Китайски (традиционен, Макао) | Китайски (традиционен, Тайван) | Хърватски | Чешки | Датски | Холандски | Фински | Френски | Немски | Гръцки | Иврит | Хинди | Унгарски | Индонезийски | Италиански | Японски | Корейски | Малайски | Маратхи | Непалски | Норвежки | Персийски (фарси) | Полски | Португалски (Бразилия) | Португалски (Португалия) | Пенджабски (Гурмуки) | Румънски | Руски | Сръбски (кирилица) | Словашки | Словенски | Испански | Суахили | Шведски | Тагалог (Филипински) | Тайландски | Турски | Украински | Урду | Виетнамски
🚀 Учебна програма за Model Context Protocol (MCP) за начинаещи
Научете MCP с практически примери на C#, Java, JavaScript, Rust, Python и TypeScript
🧠 Преглед на учебната програма за Model Context Protocol
Model Context Protocol (MCP) е иновативна рамка, създадена за стандартизиране на взаимодействията между AI модели и клиентски приложения. Тази учебна програма с отворен код предлага структурирана учебна пътека, включваща практически примери за програмиране и реални случаи на употреба, в популярни програмни езици като C#, Java, JavaScript, TypeScript и Python.
Независимо дали сте AI разработчик, системен архитект или софтуерен инженер, този наръчник е вашият цялостен ресурс за овладяване на основите на MCP и стратегии за внедряване.
🔗 Официални ресурси за MCP
- 📘 Документация за MCP – Подробни уроци и ръководства за потребители
- 📜 Спецификация на MCP – Архитектура на протокола и технически справки
- 📜 Оригинална спецификация на MCP – Технически справки от предишни версии (може да съдържат допълнителни детайли)
- 🧑💻 GitHub хранилище на MCP – SDK, инструменти и примерен код с отворен код
- 🌐 Общност на MCP – Присъединете се към дискусии и допринесете за общността
🧭 Преглед на учебната програма за 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 сървъри в продукция | Ръководство |
3.10 | Разширено използване на сървъри | Използвайте разширени сървъри за усъвършенствани функции и подобрена архитектура | Ръководство |
3.11 | Проста автентикация | Глава, показваща автентикация от началото и RBAC | Ръководство |
Модул 4-5: Практически и разширени теми | |||
04 | Практическа имплементация | SDK, дебъгване, тестване, шаблони за повторно използване на промпти | Прочетете повече |
05 | Разширени теми в MCP | Мултимодален AI, мащабиране, корпоративна употреба | Прочетете повече |
5.1 | Интеграция с Azure | MCP интеграция с Azure | Ръководство |
5.2 | Мултимодалност | Работа с множество модалности | Ръководство |
5.3 | OAuth2 демонстрация | Реализирайте OAuth2 автентикация | Ръководство |
5.4 | Root Contexts | Разберете и реализирайте root contexts | Ръководство |
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 персонализиран транспорт | Персонализирани имплементации на транспорт | Ръководство |
Модул 6-10: Общност и добри практики | |||
06 | Приноси към общността | Как да допринесете за екосистемата на MCP | Ръководство |
07 | Прозрения от ранно внедряване | Истории за реални имплементации | Ръководство |
08 | Най-добри практики за MCP | Производителност, устойчивост на грешки, устойчивост | Ръководство |
09 | Примери за MCP | Практически примери за имплементация | Ръководство |
10 | Практически семинар | Създаване на MCP сървър с AI Toolkit | Лаборатория |
Модул 11: Практическа лаборатория за MCP сървър | |||
11 | Интеграция на MCP сървър с база данни | Цялостен 13-лабораторен учебен път за интеграция с PostgreSQL | Лаборатории |
11.1 | Въведение | Преглед на MCP с интеграция на база данни и случай на употреба за анализ на продажби | Лаборатория 00 |
11.2 | Основна архитектура | Разбиране на архитектурата на MCP сървъра, слоевете на базата данни и моделите за сигурност | Лаборатория 01 |
11.3 | Сигурност и мултитенантност | Сигурност на ниво ред, автентикация и достъп до данни за множество наематели | Лаборатория 02 |
11.4 | Настройка на среда | Настройка на среда за разработка, Docker, ресурси в Azure | Лаборатория 03 |
11.5 | Дизайн на база данни | Настройка на PostgreSQL, дизайн на ритейл схема и примерни данни | Лаборатория 04 |
11.6 | Имплементация на MCP сървър | Създаване на FastMCP сървър с интеграция на база данни | Лаборатория 05 |
11.7 | Разработка на инструменти | Създаване на инструменти за заявки към база данни и инспекция на схема | Лаборатория 06 |
11.8 | Семантично търсене | Имплементация на векторни вграждания с Azure OpenAI и pgvector | Лаборатория 07 |
11.9 | Тестване и дебъгване | Стратегии за тестване, инструменти за дебъгване и подходи за валидиране | Лаборатория 08 |
11.10 | Интеграция с VS Code | Конфигуриране на MCP интеграция с VS Code и използване на AI Chat | Лаборатория 09 |
11.11 | Стратегии за разгръщане | Разгръщане с Docker, Azure Container Apps и мащабиране | Лаборатория 10 |
11.12 | Мониторинг | Application Insights, логове, мониторинг на производителността | Лаборатория 11 |
11.13 | Най-добри практики | Оптимизация на производителността, засилване на сигурността и съвети за продукция | Лаборатория 12 |
💻 Примерни проекти с код
Основни примери за MCP калкулатор
Език | Описание | Линк |
---|---|---|
C# | Пример за MCP сървър | Виж кода |
Java | MCP калкулатор | Виж кода |
JavaScript | MCP демонстрация | Виж кода |
Python | MCP сървър | Виж кода |
TypeScript | MCP пример | Виж кода |
Rust | MCP пример | Виж кода |
Разширени имплементации на MCP
Език | Описание | Линк |
---|---|---|
C# | Разширен пример | Виж кода |
Java със Spring | Пример за контейнерно приложение | Виж кода |
JavaScript | Разширен пример | Виж кода |
Python | Комплексна имплементация | Виж кода |
TypeScript | Пример за контейнер | Виж кода |
🎯 Предварителни изисквания за изучаване на MCP
За да извлечете максимума от тази учебна програма, трябва да имате:
Основни познания по програмиране на поне един от следните езици: C#, Java, JavaScript, Python или TypeScript
Разбиране на модела клиент-сървър и API
Запознатост с концепции за REST и HTTP
(Опционално) Основи на AI/ML концепции
Присъединяване към нашите дискусии в общността за подкрепа
📚 Учебно ръководство и ресурси
Този репозиторий включва няколко ресурса, които да ви помогнат да се ориентирате и учите ефективно:
Учебно ръководство
Подробно Учебно ръководство е налично, за да ви помогне да се ориентирате в този репозиторий. Ръководството включва:
- Визуална карта на учебната програма, показваща всички обхванати теми
- Детайлно разглеждане на всяка секция от репозитория
- Насоки за използване на примерните проекти
- Препоръчителни учебни пътеки за различни нива на умения
- Допълнителни ресурси за допълване на учебния процес
Дневник на промените
Поддържаме подробен Дневник на промените, който проследява всички значителни актуализации на учебните материали, включително:
- Добавяне на ново съдържание
- Структурни промени
- Подобрения на функциите
- Актуализации на документацията
🛠️ Как да използвате тази учебна програма ефективно
Всяка лекция в това ръководство включва:
- Ясни обяснения на MCP концепции
- Примери с жив код на различни езици
- Упражнения за създаване на реални MCP приложения
- Допълнителни ресурси за напреднали учащи
Събития
MCP Dev Days юли 2025
➡️Гледайте на запис - MCP Dev Days
Пригответе се за два дни на задълбочени технически прозрения, връзка с общността и практически обучения на MCP Dev Days, виртуално събитие, посветено на Model Context Protocol (MCP) — нововъзникващ стандарт, който свързва AI модели и инструментите, на които те разчитат. Можете да гледате MCP Dev Days, като се регистрирате на нашата страница за събития: https://aka.ms/mcpdevdays.
Ден 1: MCP продуктивност, DevTools и общност:
Посветен на овластяването на разработчиците да използват MCP в своя работен процес и празнуването на невероятната MCP общност. Ще се присъединим към членове на общността и партньори като Arcade, Block, Okta и Neon, за да видим как те си сътрудничат с Microsoft за изграждане на отворена, разширяема MCP екосистема.
Реални демонстрации с VS Code, Visual Studio, GitHub Copilot и популярни инструменти на общността
Практически, контекстно ориентирани работни процеси за разработка
Сесии, водени от общността, и прозрения
Независимо дали тепърва започвате с MCP или вече работите с него, Ден 1 ще ви вдъхнови и предостави приложими идеи.
Ден 2: Създавайте MCP сървъри с увереност
Посветен на MCP разработчиците. Ще се задълбочим в стратегии за имплементация и най-добри практики за създаване на MCP сървъри и интегриране на MCP във вашите AI работни процеси.
Теми включват:
- Създаване на MCP сървъри и интегрирането им в агентски преживявания
- Разработка, водена от промпти
- Най-добри практики за сигурност
- Използване на градивни блокове като Functions, ACA и API Management
- Подравняване на регистъра и инструменти (1P + 3P)
Ако сте разработчик, създател на инструменти или AI продуктов стратег, този ден е изпълнен с прозрения, които ще ви помогнат да изградите мащабируеми, сигурни и готови за бъдещето MCP решения.
MCP Boot Camp август 2025
Научете в интензивни видео сесии как да създавате MCP сървъри, да интегрирате с VS Code и да разгръщате професионално в Azure, базирано на съдържанието от MCP за начинаещи. Придобийте практически умения в технология, която вече се използва от големи компании.
➡️Гледайте на запис MCP Bootcamp | Английски
➡️Гледайте на запис MCP Bootcamp | Бразилия
➡️Гледайте на запис MCP Bootcamp | Испански
Да научим MCP с C# - Серия от уроци
Да научим за Model Context Protocol (MCP), иновативна рамка, създадена да стандартизира взаимодействията между AI модели и клиентски приложения. В тази сесия за начинаещи ще ви запознаем с MCP и ще ви насочим към създаването на вашия първи MCP сървър.
C#: https://aka.ms/letslearnmcp-csharp
Java: https://aka.ms/letslearnmcp-java
JavaScript: https://aka.ms/letslearnmcp-javascript
Python: https://aka.ms/letslearnmcp-python
🌟 Благодарности към общността
Благодарности към 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-11): Основното съдържание, организирано в единадесет последователни модула, включително лаборатории за интеграция на база данни
- 11-MCPServerHandsOnLabs/: Пълна учебна пътека с 13 лаборатории за създаване на MCP сървъри, готови за продукция, с интеграция на PostgreSQL
- 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
- Овладяване на GitHub Copilot за C#/.NET разработчици
- Избери своето приключение с Copilot
™️ Уведомление за търговска марка
Този проект може да съдържа търговски марки или лога на проекти, продукти или услуги. Разрешеното използване на търговски марки или лога на Microsoft трябва да се съобразява с и да следва Насоките за търговски марки и бранд на Microsoft.
Използването на търговски марки или лога на Microsoft в модифицирани версии на този проект не трябва да предизвиква объркване или да предполага спонсорство от страна на Microsoft.
Всяко използване на търговски марки или лога на трети страни трябва да се съобразява с политиките на съответните трети страни.
Получаване на помощ
Ако се затрудните или имате въпроси относно създаването на AI приложения, присъединете се към:
Ако имате обратна връзка за продукта или срещнете грешки по време на разработката, посетете:
Отказ от отговорност:
Този документ е преведен с помощта на AI услуга за превод Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или погрешни интерпретации, произтичащи от използването на този превод.