MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Следвайте тези стъпки, за да започнете да използвате тези ресурси:

  1. Направете Fork на хранилището: Кликнете GitHub forks
  2. Клонирайте хранилището: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Присъединете се към 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

📚 Пълна структура на учебната програма

МодулТемаОписаниеЛинк
Модул 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.5stdio сървърСъздайте сървъри, използващи stdio транспортРъководство
3.6HTTP стриймингРеализирайте HTTP стрийминг в MCPРъководство
3.7AI ToolkitИзползвайте AI Toolkit с MCPРъководство
3.8ТестванеТествайте вашата MCP сървърна имплементацияРъководство
3.9ДеплоймънтДеплойвайте MCP сървъри в продукцияРъководство
3.10Разширено използване на сървъриИзползвайте разширени сървъри за усъвършенствани функции и подобрена архитектураРъководство
3.11Проста автентикацияГлава, показваща автентикация от началото и RBACРъководство
Модул 4-5: Практически и разширени теми
04Практическа имплементацияSDK, дебъгване, тестване, шаблони за повторно използване на промптиПрочетете повече
05Разширени теми в MCPМултимодален AI, мащабиране, корпоративна употребаПрочетете повече
5.1Интеграция с AzureMCP интеграция с AzureРъководство
5.2МултимодалностРабота с множество модалностиРъководство
5.3OAuth2 демонстрацияРеализирайте OAuth2 автентикацияРъководство
5.4Root ContextsРазберете и реализирайте root contextsРъководство
5.5РоутингСтратегии за роутинг в MCPРъководство
5.6СемплиранеТехники за семплиране в MCPРъководство
5.7МащабиранеМащабирайте MCP имплементацииРъководство
5.8СигурностРазширени съображения за сигурностРъководство
5.9Уеб търсенеРеализирайте възможности за уеб търсенеРъководство
5.10Реално време стриймингСъздайте функционалност за стрийминг в реално времеРъководство
5.11Търсене в реално времеРеализирайте търсене в реално времеРъководство
5.12Entra ID автентикацияАвтентикация с Microsoft Entra IDРъководство
5.13Интеграция с FoundryИнтеграция с Azure AI FoundryРъководство
5.14Инженеринг на контекстиТехники за ефективен инженеринг на контекстиРъководство
5.15MCP персонализиран транспортПерсонализирани имплементации на транспортРъководство
Модул 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 сървърВиж кода
JavaMCP калкулаторВиж кода
JavaScriptMCP демонстрацияВиж кода
PythonMCP сървърВиж кода
TypeScriptMCP примерВиж кода
RustMCP примерВиж кода

Разширени имплементации на MCP

ЕзикОписаниеЛинк
C#Разширен примерВиж кода
Java със SpringПример за контейнерно приложениеВиж кода
JavaScriptРазширен примерВиж кода
PythonКомплексна имплементацияВиж кода
TypeScriptПример за контейнерВиж кода

🎯 Предварителни изисквания за изучаване на MCP

За да извлечете максимума от тази учебна програма, трябва да имате:

  • Основни познания по програмиране на поне един от следните езици: C#, Java, JavaScript, Python или TypeScript

  • Разбиране на модела клиент-сървър и API

  • Запознатост с концепции за REST и HTTP

  • (Опционално) Основи на AI/ML концепции

  • Присъединяване към нашите дискусии в общността за подкрепа

📚 Учебно ръководство и ресурси

Този репозиторий включва няколко ресурса, които да ви помогнат да се ориентирате и учите ефективно:

Учебно ръководство

Подробно Учебно ръководство е налично, за да ви помогне да се ориентирате в този репозиторий. Ръководството включва:

  • Визуална карта на учебната програма, показваща всички обхванати теми
  • Детайлно разглеждане на всяка секция от репозитория
  • Насоки за използване на примерните проекти
  • Препоръчителни учебни пътеки за различни нива на умения
  • Допълнителни ресурси за допълване на учебния процес

Дневник на промените

Поддържаме подробен Дневник на промените, който проследява всички значителни актуализации на учебните материали, включително:

  • Добавяне на ново съдържание
  • Структурни промени
  • Подобрения на функциите
  • Актуализации на документацията

🛠️ Как да използвате тази учебна програма ефективно

Всяка лекция в това ръководство включва:

  1. Ясни обяснения на MCP концепции
  2. Примери с жив код на различни езици
  3. Упражнения за създаване на реални MCP приложения
  4. Допълнителни ресурси за напреднали учащи

Събития

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: Документи за управление на проекта

🎒 Други курсове

Нашият екип създава и други курсове! Вижте:

™️ Уведомление за търговска марка

Този проект може да съдържа търговски марки или лога на проекти, продукти или услуги. Разрешеното използване на търговски марки или лога на Microsoft трябва да се съобразява с и да следва Насоките за търговски марки и бранд на Microsoft.
Използването на търговски марки или лога на Microsoft в модифицирани версии на този проект не трябва да предизвиква объркване или да предполага спонсорство от страна на Microsoft.
Всяко използване на търговски марки или лога на трети страни трябва да се съобразява с политиките на съответните трети страни.

Получаване на помощ

Ако се затрудните или имате въпроси относно създаването на AI приложения, присъединете се към:

Azure AI Foundry Discord

Ако имате обратна връзка за продукта или срещнете грешки по време на разработката, посетете:

Azure AI Foundry Developer Forum


Отказ от отговорност:
Този документ е преведен с помощта на AI услуга за превод Co-op Translator. Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи може да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или погрешни интерпретации, произтичащи от използването на този превод.