Skip to content

Latest commit

 

History

History
263 lines (193 loc) · 27.1 KB

File metadata and controls

263 lines (193 loc) · 27.1 KB

MCP-за-начинаещи

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

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

  1. Форкнете хранилището: Кликнете 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, Python и TypeScript

🧠 Преглед на учебната програма за Model Context Protocol

Model Context Protocol (MCP) е модерна рамка, създадена да стандартизира взаимодействията между AI модели и клиентски приложения. Тази отворена учебна програма предлага структуриран път на обучение, включващ практически примери с код и реални случаи на употреба, на популярни програмни езици като C#, Java, JavaScript, TypeScript и Python.

Независимо дали сте AI разработчик, системен архитект или софтуерен инженер, това ръководство е вашият изчерпателен ресурс за овладяване на основите и стратегиите за внедряване на MCP.

🔗 Официални ресурси за MCP

Присъединете се към MCP Dev Days на 29-30 юли 2025 г.

Подгответе се за два дни с дълбоки технически познания, свързване с общността и практическо обучение на MCP Dev Days – виртуално събитие, посветено на Model Context Protocol (MCP) — новия стандарт, който свързва AI модели и инструментите, на които разчитат.

➡️ Регистрирайте се за MCP Dev Days

Можете да гледате MCP Dev Days, като се регистрирате на нашата страница за събитието: https://aka.ms/mcpdevdays. Оттам ще можете да се включите в живо предаване в YouTube или Twitch. Цялото съдържание се записва и ще бъде достъпно след това в YouTube канала на Microsoft Developer. Изходният код за демонстрациите също ще бъде наличен в GitHub.

Детайли за събитието

  • Дати: 29 юли (Ден 1) и 30 юли (Ден 2)
  • Час: 9:00 AM PST всеки ден
  • Място: Онлайн – присъединете се от всяко място!

Ден 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

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

Модул Тема Описание Връзка
Модули 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 SSE сървър Създайте сървъри с Server-Sent Events Ръководство
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 Guide
5.13 Foundry Integration Интеграция с Azure AI Foundry Guide
5.14 Context Engineering Техники за ефективно управление на контекста Guide
Модул 6-10: Общество и добри практики
06 Приноси от общността Как да допринасяте за екосистемата на MCP Guide
07 Уроци от ранно приемане Истории за реални реализации Guide
08 Добри практики за MCP Производителност, устойчивост и надеждност Guide
09 Казуси на MCP Практически примери за реализация Guide
10 Практически семинар Създаване на MCP сървър с AI Toolkit Lab

💻 Примерни кодови проекти

Основни примери за MCP калкулатор

Език Описание Връзка
C# Пример за MCP сървър View Code
Java MCP калкулатор View Code
JavaScript Демонстрация на MCP View Code
Python MCP сървър View Code
TypeScript Пример за MCP View Code

Разширени реализации на MCP

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

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

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

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

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

  • Познания за REST и HTTP концепции

  • (По избор) Опит с AI/ML концепции

  • Участие в дискусиите на нашата общност за подкрепа

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

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

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

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

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

Промени в съдържанието

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

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

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

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

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

🌟 Благодарности към общността

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

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

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

™️ Забележка за търговска марка

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

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