Следвайте тези стъпки, за да започнете да използвате тези ресурси:
- Направете Fork на хранилището: Кликнете
- Клонирайте хранилището:
git clone https://github.com/microsoft/mcp-for-beginners.git - Присъединете се към
Arabic | Bengali | Bulgarian | Burmese (Myanmar) | Chinese (Simplified) | Chinese (Traditional, Hong Kong) | Chinese (Traditional, Macau) | Chinese (Traditional, Taiwan) | Croatian | Czech | Danish | Dutch | Estonian | Finnish | French | German | Greek | Hebrew | Hindi | Hungarian | Indonesian | Italian | Japanese | Kannada | Khmer | Korean | Lithuanian | Malay | Malayalam | Marathi | Nepali | Nigerian Pidgin | Norwegian | Persian (Farsi) | Polish | Portuguese (Brazil) | Portuguese (Portugal) | Punjabi (Gurmukhi) | Romanian | Russian | Serbian (Cyrillic) | Slovak | Slovenian | Spanish | Swahili | Swedish | Tagalog (Filipino) | Tamil | Telugu | Thai | Turkish | Ukrainian | Urdu | Vietnamese
Предпочитате да клонирате локално?
Това хранилище включва над 50 превода, което значително увеличава размера на изтегляне. За да клонирате без преводи, използвайте sparse checkout:
Bash / macOS / Linux:
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone '/*' '!translations' '!translated_images'CMD (Windows):
git clone --filter=blob:none --sparse https://github.com/microsoft/mcp-for-beginners.git cd mcp-for-beginners git sparse-checkout set --no-cone "/*" "!translations" "!translated_images"Така ще получите всичко необходимо за завършване на курса с много по-бързо изтегляне.
Добре дошли в пътуването си в Model Context Protocol! Ако някога сте се чудили как приложенията за изкуствен интелект комуникират с различни инструменти и услуги, скоро ще откриете елегантното решение, което трансформира начина, по който разработчиците създават интелигентни системи.
Помислете за MCP като универсален преводач за AI приложения - точно както USB портовете ви позволяват да свързвате всяко устройство към компютъра си, MCP позволява на AI моделите да се свързват с всеки инструмент или услуга по стандартизиран начин. Независимо дали създавате първия си чатбот или работите по сложни AI работни потоци, разбирането на MCP ще ви даде силата да създавате по-способни и гъвкави приложения.
Тази учебна програма е създадена с търпение и грижа за вашето пътешествие на обучение. Ще започнем с прости концепции, които вече разбирате, и постепенно ще изграждаме вашата експертиза чрез практическа работа на любимия ви програмен език. Всяка стъпка включва ясни обяснения, практически примери и много насърчение по пътя.
Когато приключите това пътешествие, ще имате увереността да изграждате свои собствени MCP сървъри, да ги интегрирате с популярни AI платформи и да разберете как тази технология преоформя бъдещето на разработката на AI. Нека започнем това вълнуващо приключение заедно!
Тази учебна програма е съобразена с MCP Спецификация 2025-11-25 (най-новата стабилна версия). MCP спецификацията използва версиониране на базата на дати (формат ГГГГ-ММ-ДД), за да осигури ясно проследяване на версиите на протокола.
Тези ресурси стават по-ценни с нарастването на вашето разбиране, но не се чувствайте под напрежение да четете всичко веднага. Започнете с областите, които ви интересуват най-много!
- 📘 MCP Документация – Това е вашият основен ресурс за стъпка по стъпка уроци и потребителски ръководства. Документацията е написана с мисъл за начинаещи, предоставяйки ясни примери, които можете да следвате със собствено темпо.
- 📜 MCP Спецификация – Помислете за това като вашия изчерпателен справочник. Докато напредвате в учебната програма, ще се връщате тук, за да търсите конкретни детайли и да изследвате разширени функции.
- 📜 Версиониране на MCP Спецификацията – Тук ще намерите информация за историята на версиите на протокола и как MCP използва версиониране на базата на дати (формат ГГГГ-ММ-ДД).
- 🧑💻 MCP GitHub Хранилище – Тук ще намерите SDK-та, инструменти и кодови примери на различни програмни езици. Това е като съкровищница от практически примери и готови за използване компоненти.
- 🌐 MCP Общество – Присъединете се към съученици и опитни разработчици в дискусии за MCP. Това е подкрепяща общност, където въпросите са добре дошли и знанието се споделя свободно.
Към края на тази учебна програма ще се чувствате уверени и въодушевени от новите си умения. Ето какво ще постигнете:
• Разберете основите на MCP: Ще проумеете какво е Model Context Protocol и защо той революционизира начина, по който AI приложенията работят заедно, използвайки аналогии и примери, които са лесни за разбиране.
• Създайте първия си MCP сървър: Ще изградите работещ MCP сървър на предпочитания от вас програмен език, започвайки с прости примери и развивайки уменията си стъпка по стъпка.
• Свържете AI модели с реални инструменти: Ще научите как да създадете мост между AI моделите и действителните услуги, давайки на приложенията си мощни нови възможности.
• Прилагайте най-добри практики за сигурност: Ще разберете как да запазите реализациите на MCP безопасни и защитени, като защитавате както приложенията си, така и потребителите.
• Разгръщайте с увереност: Ще знаете как да пренесете MCP проектите си от разработка до продукция, с практични стратегии за внедряване, които работят в реалния свят.
• Присъединете се към MCP общността: Ще станете част от растяща общност от разработчици, които оформят бъдещето на разработката на AI приложения.
Преди да се потопим в подробностите за MCP, нека се уверим, че сте запознати с някои фундаментални концепции. Не се притеснявайте, ако не сте експерт в тези области - ние ще обясним всичко, което трябва да знаете, докато напредваме!
Помислете за протокола като за правилата на един разговор. Когато се обаждате на приятел, и двамата знаете, че казвате „здравей“ при отговор, редувате се да говорите и казвате „довиждане“ когато приключите. Компютърните програми имат нужда от подобни правила, за да комуникират ефективно.
MCP е протокол - набор от договорени правила, които помагат на AI моделите и приложенията да имат продуктивни „разговори“ с инструменти и услуги. Точно както правилата за разговор улесняват човешката комуникация, MCP прави комуникацията между AI приложенията по-надеждна и мощна.
Вие вече използвате връзки клиент-сървър всеки ден! Когато използвате уеб браузър (клиент) за посещение на уебсайт, вие се свързвате с уеб сървър, който ви изпраща съдържанието на страницата. Браузърът знае как да поиска информация, а сървърът знае как да отговори.
В MCP имаме подобна връзка: AI моделите действат като клиенти, които искат информация или действия, а MCP сървърите предоставят тези възможности. Това е като да имате полезен асистент (сървър), на когото AI може да поиска да изпълни конкретни задачи.
Представете си, че всеки производител на автомобили използва различна форма на пистолети за гориво - щяхте да имате нужда от различен адаптер за всяка кола! Стандартизацията означава съгласие за общи подходи, за да работят нещата безпроблемно заедно.
MCP осигурява тази стандартизация за AI приложенията. Вместо всеки AI модел да се нуждае от индивидуален код за работа с всеки инструмент, MCP създава универсален начин за комуникация. Това означава, че разработчиците могат да създадат инструменти веднъж и те да работят с много различни AI системи.
Пътуването ви с MCP е внимателно структурирано, за да изгражда вашето доверие и умения постепенно. Всяка фаза въвежда нови концепции, като затвърждава вече наученото.
Тук започва вашето приключение! Ще ви запознаем с концепциите на MCP, използвайки познати аналогии и прости примери. Ще разберете какво е MCP, защо съществува и как се вписва в по-големия свят на разработката на AI.
• Модул 0 - Въведение в MCP: Започваме с изследване какво е MCP и защо е толкова важно за съвременните AI приложения. Ще видите реални примери за MCP в действие и ще разберете как решава често срещани проблеми пред разработчиците.
• Модул 1 - Обяснение на основните концепции: Тук ще научите основните градивни блокове на MCP. Ще използваме много аналогии и визуални примери, за да направим тези концепции естествени и лесни за разбиране.
• Модул 2 - Сигурност в MCP: Сигурността може да звучи плашещо, но ние ще ви покажем как MCP включва вътрешни функции за безопасност и ще ви научим на най-добрите практики за защита на вашите приложения от самото начало.
Сега започва истинското забавление! Ще получите практически опит с изграждането на реални MCP сървъри и клиенти. Не се притеснявайте - ще започнем с основите и ще ви водим през всяка стъпка.
Този модул включва множество практически ръководства, които ви позволяват да упражнявате във вашия предпочитан програмен език. Ще създадете първия си сървър, ще изградите клиент за свързване към него и дори ще интегрирате с популярни инструменти за разработка като VS Code.
Всяко ръководство включва пълни примери с код, съвети за отстраняване на проблеми и обяснения защо правим конкретни дизайнерски решения. До края на тази фаза ще имате работещи MCP имплементации, с които да се гордеете!
След като сте усвоили основите, сте готови да изследвате по-сложни функции на MCP. Ще разгледаме практични стратегии за имплементация, техники за отстраняване на грешки и напреднали теми като мултимодална интеграция на изкуствен интелект.
Също така ще научите как да мащабирате вашите MCP имплементации за производствена употреба и как да интегрирате с облачни платформи като Azure. Тези модули ви подготвят да изграждате MCP решения, които да се справят с реални изисквания.
Последната фаза е насочена към включване в MCP общността и специализиране в области, които ви интересуват най-много. Ще научите как да допринасяте за проекти с отворен код на MCP, да прилагате напреднали модели за удостоверяване и да изграждате комплексни решения с интеграция на бази данни.
Модул 11 заслужава специално внимание - това е завършен път за обучение с 13 практически лаборатории, който ви учи да изграждате производствени MCP сървъри с интеграция на PostgreSQL. Това е като завършващ проект, който обединява всичко, което сте научили!
| Модул | Тема | Описание | Връзка |
|---|---|---|---|
| Модули 0-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 | Microsoft Foundry Toolkit | Използвайте Microsoft Foundry Toolkit с MCP | Ръководство |
| 3.8 | Тестване | Тествайте вашата MCP сървърна имплементация | Ръководство |
| 3.9 | Деплоймент | Пуснете MCP сървъри в продукция | Ръководство |
| 3.10 | Разширено използване на сървъри | Използвайте разширени сървъри за сложни функции и подобрена архитектура | Ръководство |
| 3.11 | Простa автентикация | Глава, показваща автентикация от началото и RBAC | Ръководство |
| 3.12 | MCP хостове | Конфигурирайте Claude Desktop, Cursor, Cline и други MCP хостове | Ръководство |
| 3.13 | MCP инспектор | Отстранявайте грешки и тествайте MCP сървъри с инспекторски инструмент | Ръководство |
| 3.14 | Семплиране | Използвайте семплиране за сътрудничество с клиента | Ръководство |
| 3.15 | MCP приложения | Изграждайте MCP приложения | Ръководство |
| Модули 4-5: Практически и напреднали | |||
| 04 | Практическа имплементация | SDK, отстраняване на грешки, тестване, използваеми шаблони за подпитки | Прочетете повече |
| 4.1 | Пагинация | Обработка на големи резултати с курсорно базирана пагинация | Ръководство |
| 05 | Напреднали теми в MCP | Мултимодален AI, мащабиране, корпоративна употреба | Прочетете повече |
| 5.1 | Интеграция с Azure | MCP интеграция с Azure | Ръководство |
| 5.2 | Мултимодалност | Работа с множество модалности | Ръководство |
| 5.3 | Демонстрация OAuth2 | Имплементирайте OAuth2 автентикация | Ръководство |
| 5.4 | Root контексти | Разбиране и имплементация на root контексти | Ръководство |
| 5.5 | Роутинг | MCP стратегии за роутинг | Ръководство |
| 5.6 | Семплиране | Техники на семплиране в MCP | Ръководство |
| 5.7 | Мащабиране | Мащабирайте MCP имплементации | Ръководство |
| 5.8 | Сигурност | Напреднали съображения за сигурност | Ръководство |
| 5.9 | Уеб търсене | Имплементирайте възможности за уеб търсене | Ръководство |
| 5.10 | Реално време стрийминг | Изградете функционалност за стрийминг в реално време | Ръководство |
| 5.11 | Търсене в реално време | Имплементирайте търсене в реално време | Ръководство |
| 5.12 | Avтентикация с Entra ID | Автентикация с Microsoft Entra ID | Ръководство |
| 5.13 | Интеграция с Foundry | Интеграция с Microsoft Foundry | Ръководство |
| 5.14 | Контекстна инженерия | Техники за ефективна контекстна инженерия | Ръководство |
| 5.15 | Персонализиран MCP транспорт | Имплементации на персонализиран транспорт | Ръководство |
| 5.16 | Протоколни функции | Известия за напредък, анулиране, шаблони за ресурси | Ръководство |
| 5.17 | Противопоставено многогодишно разсъждение | Двама агенти спорят противоположни страни с общи MCP инструменти, оценявани от агент съдия | Ръководство |
| Модули 6-10: Общност и добри практики | |||
| 06 | Приноси от общността | Как да допринесете към MCP екосистемата | Ръководство |
| 07 | Уроци от ранно внедряване | Истории от реални имплементации | Ръководство |
| 08 | Добри практики за MCP | Производителност, толеранс към грешки, устойчивост | Ръководство |
| 09 | Казуси MCP | Практически примери за имплементация | Ръководство |
| 10 | Практически семинар | Изграждане на MCP сървър с Microsoft Foundry Toolkit | Лаборатория |
| Модул 11: Практически лаборатории MCP сървър | |||
| 11 | MCP сървър с интеграция на база данни | Комплексен път за обучение с 13 лаборатории за интеграция с PostgreSQL | Лаборатории |
| 11.1 | Въведение | Преглед на MCP с интеграция на база данни и използване в търговско анализиране | Лаб 00 |
| 11.2 | Основна архитектура | Разбиране на архитектурата на MCP сървъра, слоевете на базата и модели на сигурност | Лаб 01 |
| 11.3 | Сигурност и мулти-тенантност | Row Level Security, удостоверяване и мулти-тенант достъп до данни | Лаб 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 чат | Лаб 09 |
| 11.11 | Стратегии за деплоймент | Docker деплоймент, Azure Container Apps и съображения за мащабиране | Лаб 10 |
| 11.12 | Мониторинг | Application Insights, логиране, мониторинг на производителност | Лаб 11 |
| 11.13 | Добри практики | Оптимизация на производителност, укрепване на сигурността и съвети за продукция | Лаб 12 |
| Модул 12: MCP Инструменти | |||
| 12.1 | Инструменти | Използване на MCP в Copilot App | Ръководство |
Една от най-вълнуващите части на ученето на MCP е да наблюдавате развитието на вашите умения с код постепенно. Ние сме проектирали нашите примери с код да започват просто и да стават все по-сложни с разрастването на разбирането ви. Ето как представяме концепциите - с код, който е лесен за разбиране, но демонстрира реални MCP принципи, ще разберете не само какво прави този код, но и защо е структуриран по този начин и как се вписва в по-големи MCP приложения.
| Език | Описание | Връзка |
|---|---|---|
| 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 приложения
- Допълнителни ресурси за напреднали учащи се
Нека научим за Model Context Protocol (MCP), модерна рамка, създадена за стандартизиране на взаимодействията между AI модели и клиентски приложения. Чрез тази сесия за начинаещи ще ви запознаем с MCP и ще ви отведем през създаването на първия ви MCP сървър.
JavaScript: https://aka.ms/letslearnmcp-javascript
Поздравления! Току-що направихте първата крачка в едно вълнуващо пътешествие, което ще разшири вашите програмни възможности и ще ви свърже с най-новото в развитието на ИИ.
Чрез прочитането на това въведение вече сте започнали да изграждате своята основа за знания за MCP. Разбирате какво е MCP, защо е важно и как тази учебна програма ще подкрепя вашето учене. Това е значимо постижение и начало на вашата експертиза в тази важна технология.
Докато напредвате в модулите, помнете, че всеки експерт някога е бил начинаещ. Концепциите, които сега могат да изглеждат сложни, ще станат втора природа, докато практикувате и ги прилагате. Всяка малка крачка строи мощни умения, които ще ви служат през цялата ви разработваческа кариера.
Присъединявате се към общност от учащи се и експерти, които са страстни към MCP и с желание да помогнат на другите да успеят. Независимо дали сте закъсали с кодиране или сте развълнувани да споделите пробив, общността е тук, за да поддържа вашето пътешествие.
Ако сте затруднени или имате въпроси за изграждането на AI приложения, присъединете се към други учащи се и опитни разработчици в дискусии за MCP. Това е подкрепяща общност, където въпросите са добре дошли, а знанието се споделя свободно.
Ако имате обратна връзка за продукта или грешки по време на разработка, посетете:
Вашето MCP приключение започва сега! Започнете с Модул 0, за да се потопите в първите си практически MCP преживявания, или разгледайте примерните проекти, за да видите какво ще създавате. Помнете - всеки експерт е започнал точно там, където сте вие сега, и с търпение и практика ще се учудите какво можете да постигнете.
Добре дошли в света на разработката по Model Context Protocol. Нека създадем нещо изумително заедно!
Тази учебна програма става по-силна с приноси от учащи се като вас! Независимо дали поправяте печатна грешка, предлагате по-ясно обяснение или добавяте нов пример, вашите приноси помагат на другите начинаещи да успеят.
Благодарности на Microsoft Valued Professional Shivam Goyal за предоставените кодови примери.
Процесът на принос е проектиран да бъде приветлив и подкрепящ. Повечето приноси изискват подписване на Contributor License Agreement (CLA), но автоматизираните инструменти ще ви преведат гладко през процеса.
Цялата тази учебна програма е достъпна под MIT LICENSE, което означава, че можете свободно да я използвате, модифицирате и споделяте. Това подкрепя нашата мисия за правене на знания за MCP достъпни за разработчици по целия свят.
Този проект приветства приноси и предложения. Повечето приноси изискват да се съгласите с Contributor License Agreement (CLA), който заявява, че имате право и наистина предоставяте на нас правата да използваме вашия принос. За подробности посетете https://cla.opensource.microsoft.com.
Когато изпратите pull request, CLA бот автоматично ще определи дали трябва да предоставите CLA и ще маркира заявката (например, проверка на статус, коментар). Просто следвайте инструкциите, дадени от бота. Това се прави само веднъж за всички репозитории, използващи нашия CLA.
Този проект е приел Microsoft Open Source Code of Conduct. За повече информация вижте Често задавани въпроси за кодекса на поведение или се свържете с opencode@microsoft.com за допълнителни въпроси или коментари.
Готови да започнете вашето MCP пътешествие? Започнете с Модул 00 - Въведение в MCP и направете първите си крачки в света на разработката с Model Context Protocol!
Нашият екип създава и други курсове! Разгледайте:
-9333EA?style=for-the-badge&labelColor=E5E7EB&color=9333EA){kind=icon}
-C084FC?style=for-the-badge&labelColor=E5E7EB&color=C084FC){kind=icon}
-E879F9?style=for-the-badge&labelColor=E5E7EB&color=E879F9){kind=icon}
Отказ от отговорност: Този документ е преведен с помощта на AI преводачески услуга Co-op Translator. Въпреки че се стремим към точност, моля имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод.