Follow these steps to get started using these resources:
- Fork the Repository: Click
- Clone the Repository:
git clone https://github.com/microsoft/mcp-for-beginners.git - Join The
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! Якщо ви коли-небудь замислювалися, як AI-додатки спілкуються з різними інструментами та сервісами, ви ось-ось дізнаєтеся про елегантне рішення, яке змінює спосіб створення розумних систем розробниками.
Уявіть MCP як універсальний перекладач для AI-додатків — так само, як USB-порти дозволяють підключати будь-який пристрій до комп’ютера, MCP дозволяє AI-моделям підключатися до будь-якого інструменту чи сервісу у стандартизований спосіб. Чи ви створюєте свого першого чатбота, чи працюєте над складними AI-робочими процесами, розуміння MCP дасть вам змогу розробляти більш потужні та гнучкі додатки.
Ця навчальна програма створена з терпінням і турботою про ваш процес навчання. Ми почнемо з простих понять, які ви вже розумієте, і поступово нарощуватимемо вашу експертизу через практичні вправи на улюбленій мові програмування. Кожен крок містить чіткі пояснення, практичні приклади та багато підбадьорення.
До того моменту, коли ви завершите цю подорож, ви будете впевнено створювати власні MCP-сервери, інтегрувати їх з популярними AI-платформами та розуміти, як ця технологія формує майбутнє розробки AI. Розпочнемо цю захоплюючу пригоду разом!
Ця навчальна програма відповідає MCP Specification 2025-11-25 (остання стабільна версія). Специфікація MCP використовує версіонування за датою (формат YYYY-MM-DD) для забезпечення чіткого відстеження версії протоколу.
Ці ресурси стануть для вас ще ціннішими зі зростанням розуміння, але не відчувайте тиску читати все одразу. Почніть з тих тем, що найцікавіші!
- 📘 Документація MCP – це ваш головний ресурс із покроковими підручниками та інструкціями користувача. Документація написана з урахуванням початківців, містить чіткі приклади, які ви можете виконувати у зручному для вас темпі.
- 📜 Специфікація MCP – розглядайте це як ваш всебічний довідник. Працюючи над програмою, ви повертатиметесь сюди, щоб шукати конкретні деталі та досліджувати розширені функції.
- 📜 Версіонування MCP Specification – тут міститься інформація про історію версій протоколу та про те, як MCP використовує версіонування за датою (формат YYYY-MM-DD).
- 🧑💻 Репозиторій 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 і спеціалізації у тих сферах, які вас найбільше цікавлять. Ви навчитеся долучатися до open-source 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 | AI Toolkit | Використання AI Toolkit з MCP | Посібник |
| 3.8 | Тестування | Тестуйте реалізацію серверів MCP | Посібник |
| 3.9 | Розгортання | Розгортання серверів MCP у виробництві | Посібник |
| 3.10 | Використання просунутих серверів | Використання просунутих серверів для складних функцій та покращеної архітектури | Посібник |
| 3.11 | Простий аутентифікатор | Розділ, що показує автентифікацію з початку та RBAC | Посібник |
| 3.12 | Хости MCP | Налаштування Claude Desktop, Cursor, Cline та інших хостів MCP | Посібник |
| 3.13 | MCP Inspector | Налагодження та тестування серверів MCP за допомогою інструменту Inspector | Посібник |
| 3.14 | Семплінг | Використання вибірки для співпраці з клієнтом | Посібник |
| 3.15 | MCP Apps | Створення MCP додатків | Посібник |
| Модулі 4-5: Практичне та просунуте | |||
| 04 | Практичне впровадження | SDK, налагодження, тестування, повторно використовувані шаблони промптів | Читати далі |
| 4.1 | Пагінація | Обробка великих наборів результатів з курсорною пагінацією | Посібник |
| 05 | Просунуті теми MCP | Мультимодальний ШІ, масштабування, корпоративне використання | Читати далі |
| 5.1 | Інтеграція Azure | Інтеграція MCP з Azure | Посібник |
| 5.2 | Мультимодальність | Робота з кількома модальностями | Посібник |
| 5.3 | Демонстрація OAuth2 | Впровадження автентифікації OAuth2 | Посібник |
| 5.4 | Кореневі контексти | Розуміння та впровадження кореневих контекстів | Посібник |
| 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 | Реалізація користувацьких транспортів | Посібник |
| 5.16 | Особливості протоколу | Повідомлення про прогрес, скасування, шаблони ресурсів | Посібник |
| Модулі 6-10: Спільнота та найкращі практики | |||
| 06 | Внесок у спільноту | Як долучатися до екосистеми MCP | Посібник |
| 07 | Висновки з раннього впровадження | Історії реальних впроваджень | Посібник |
| 08 | Найкращі практики MCP | Продуктивність, стійкість, відмовостійкість | Посібник |
| 09 | Кейси MCP | Приклади практичних реалізацій | Посібник |
| 10 | Практичний семінар | Створення сервера MCP з AI Toolkit | Лабораторна |
| Модуль 11: Практична лабораторія MCP Server | |||
| 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 є поступове покращення ваших навичок програмування. Ми спроектували приклади коду так, щоб вони починалися з простого і ставали більш складними разом із поглибленням ваших знань. Ось як ми вводимо концепції — код, який легко зрозуміти, але він демонструє принципи MCP на практиці, ви зрозумієте не лише що робить цей код, а й чому він структурований таким чином і як це вписується в більші MCP-застосунки.
| Мова | Опис | Посилання |
|---|---|---|
| C# | Приклад сервера MCP | Переглянути код |
| Java | Калькулятор MCP | Переглянути код |
| JavaScript | Демонстрація MCP | Переглянути код |
| Python | Сервер MCP | Переглянути код |
| TypeScript | Приклад MCP | Переглянути код |
| Rust | Приклад MCP | Переглянути код |
| Мова | Опис | Посилання |
|---|---|---|
| C# | Просунутий приклад | Переглянути код |
| Java зі Spring | Приклад Container App | Переглянути код |
| JavaScript | Просунутий приклад | Переглянути код |
| Python | Складна реалізація | Переглянути код |
| TypeScript | Зразок контейнера | Переглянути код |
Щоб максимально ефективно використовувати цю навчальну програму, вам слід мати:
-
Базові знання програмування принаймні в одній із наступних мов: C#, Java, JavaScript, Python або TypeScript
-
Розуміння клієнт-серверної моделі та API
-
Знайомство з концепціями REST та HTTP
-
(Необов’язково) Фон у концепціях ШІ/МЛ
-
Участь у наших обговореннях спільноти для підтримки
Цей репозиторій містить кілька ресурсів, які допоможуть вам ефективно орієнтуватися та навчатися:
Доступний вичерпний Навчальний посібник, який допоможе вам ефективно орієнтуватися у цьому репозиторії. Ця візуальна карта навчальної програми показує, як усі теми взаємопов’язані, і дає поради щодо ефективного використання прикладних проєктів. Це особливо корисно для візуальних учнів, які люблять бачити загальну картину.
Посібник містить:
- Візуальну карту навчальної програми, що показує всі охоплені теми
- Детальний розбір кожного розділу репозиторію
- Рекомендації щодо використання прикладних проєктів
- Рекомендувані навчальні шляхи для різних рівнів навичок
- Додаткові ресурси для доповнення вашої навчальної подорожі
Ми ведемо детальний Журнал змін, у якому відстежуються всі значні оновлення матеріалів навчальної програми, щоб ви могли залишатися в курсі останніх покращень і доповнень.
- Додавання нового контенту
- Структурні зміни
- Поліпшення функціональності
- Оновлення документації
Кожен урок у цьому посібнику включає:
- Чіткі пояснення концепцій MCP
- Живі приклади коду на кількох мовах
- Вправи для створення реальних MCP-додатків
- Додаткові ресурси для просунутих учнів
Давайте познайомимось із Model Context Protocol (MCP), передовою структурою, розробленою для стандартизації взаємодії між ШІ-моделями та клієнтськими додатками. Через цю дружню до початківців сесію ми ознайомимо вас із MCP і проведемо через створення вашого першого MCP-сервера.
JavaScript: https://aka.ms/letslearnmcp-javascript
Вітаємо! Ви щойно зробили перший крок у захоплюючій подорожі, яка розширить ваші програмні можливості та поєднає вас з передовими досягненнями розвитку ШІ.
Прочитавши це введення, ви вже почали будувати фундамент своїх знань про MCP. Ви розумієте, що таке MCP, чому це важливо і як ця навчальна програма підтримає вашу навчальну подорож. Це значне досягнення і початок вашої експертизи у цій важливій технології.
Переходячи через модулі, пам’ятайте, що кожен експерт колись був початківцем. Концепції, що здаються складними зараз, стануть природними, коли ви почнете практикуватися та застосовувати їх. Кожен невеликий крок наближає вас до потужних можливостей, які слугуватимуть вам протягом усієї кар’єри розробника.
Ви приєднуєтесь до спільноти учнів і експертів, які захоплені MCP і прагнуть допомогти іншим досягти успіху. Чи застрягли ви на виклику кодування, чи прагнете поділитися проривом — спільнота тут, щоб підтримати вашу подорож.
Якщо ви застрягли або маєте питання щодо створення ШІ-додатків, приєднуйтесь до обговорень із іншими учнями та досвідченими розробниками про 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, і відповідно відмітить PR (наприклад, перевірка стану, коментар). Просто дотримуйтеся інструкцій бота. Вам потрібно буде зробити це лише один раз для всіх репозиторіїв, що використовують наш CLA.
Цей проєкт прийняв Кодекс поведінки Microsoft Open Source. Для більше інформації дивіться FAQ Кодексу поведінки або звертайтесь на 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}
Відмова від відповідальності:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматизовані переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критичної інформації рекомендується професійний людський переклад. Ми не несемо відповідальності за будь-які непорозуміння чи неправильні тлумачення, що виникли внаслідок використання цього перекладу.